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Purpose of this Publication 


This publication helps you to use the IBM PrintSuite for iSeries Advanced Print 
Utility (APU). It focuses on the concepts of APU, using a series of application 
examples to demonstrate how APU works. 


APU has extensive on-line help; we do not duplicate that information here. For 
details on the concepts of Advanced Function Presentation (AFP), refer to iSeries 
Guide to AFP and PSF, $544-5319. 


APU Enhancements 
The following features have been made available by the current modification level 
of APU: 


1. Duplex Printing is now available. Refer to (Pa a 
for a description of how the capability is used, incudine restrictions on its use. 


2: Fields in the SNA Character String (SCS) file can now be mapped to multiple 


Organization of the Manual 


This manual is organized into three parts, as follows: 
* Part 1 - Understanding and Preparing to use APU 


The two chapters in this part introduce new APU users to the capabilities and 
features of APU: 


1. Introducing Advanced Print Utility describes what you can do with APU. 
2. Preparing to use the Advanced Print Utility describes tasks you need to 
perform before using APU. You are also given an orientation to using the 
APU panels. 
* Part 2 - Creating Print Definitions with APU 
Each of the two chapters in this part provides you with a procedure for creating 
a print definition. One chapter provides the procedure for creating a print 
definition for a single-page document; the other for a multiple page document. 
New APU users will find it useful to create a sample print definition using one 
of these procedures before creating a production-level print definition. 
* Part 3 - Printing with APU 
The material in this part describes the concepts and procedures for printing your 
documents once you have created a print definition. 


© Copyright IBM Corp. 1996, 2002 ix 


X APU User’s Guide 


Part 1. Understanding and Preparing to Use APU 


Chapter 1. Introducing Advanced Print Utility 3 
What is APU? . 3 
What You Can Do with ‘APU . 3 
Why Use APU? 4 
Printing with and without APU . 4 
Printing without APU Soe ew a ke aod 
Printing with APU . . ........ =.5 
The Design Phase. 5 
The Production Phase 6 
APU formatting instructions . 6 
Steps in Creating an APU Dacdinent 7 
Step 1: Analyzing the Existing Application 8 
Questions you need to Ask : es, 
Example of Sample Spooled File (Sotited Input 
Data) . : . 8 
Step 2: Locating Required AFP Resourees:, 9 
Step 3: Using APU to Create a Print Definition. . 9 


Defining Page Formats . . ... . . . 10 
Defining Copies. . . < « «10 
Step 4: Printing with the Print Definition ea 210 


Chapter 2. Preparing to Use the Advanced Print 


Utility. . . . Soar et woe 2 2 18 
APU Prerequisites and Options. oe oe a 2 2 293 
Required . . . 2. 2... . ew ee 
Recommended .......... . . 13 
Optional 2 2 2 oe ee e 2 en a 2 2 2 B 
Initial APU Setup . . . . & - « 2« ¢ sd 
Font Installation Causidevations 5 a des w ae 16 
Review Document Resource Requirements. . . . 16 
Using Fonts with APU. . . . ...... . 18 
Outline Fonts. . . . . . . . . 20 
Custom Fonts. «- . 68 . « = » 4 = & @ sl 
Image Resources. . . - . . 24 
How APU Works sWithy Image Rusoniees. . . . 24 
Building Image Resources . . . . . . . . 26 
Overlay Resources . . . ha a 2. & 26 
How APU Works with Overlays » oe 4 og 3 4 27 
Building Overlay Resources. . . . . . . . 29 
Bar Code Resources. . Sou ak oe 12. 29) 
Code 3 of 9 Bar Code Example . a . 30 
POSTNET (Postal Bar Code) Bar Code Example 30 
How APU Works with Bar Codes. . . . . 30 


© Copyright IBM Corp. 1996, 2002 


2 APU User’s Guide 


Chapter 1. Introducing Advanced Print Utility 


Use this chapter to gain an understanding of what the IBM PrintSuite for iSeries 
Advanced Print Utility (APU) can do for you, including: 


e Nha A 


What is APU? 


Advanced Print Utility (APU) is part of the Advanced Function Presentation (AFP) 
PrintSuite family of document-creation systems that enables you to use SCS files as 
input to APU and then to transform that input to “full-page” electronic output, 
with pages that include electronic forms, image, bar codes, lines, boxes, and text in 
a variety of fonts. 


APU provides an interactive design approach that is independent of the 

application program. 

* The input to APU is the line-mode (SCS) output file that the line-of-business 
application creates. 

* The output of APU is an AFP spooled file. 


What You Can Do with APU 


Output specifications for iSeries application programs generate either SNA 
Character Stream (SCS) or AFP spooled files. APU works on SCS spooled files. SCS 
is a line-oriented datastream that for the most part uses preprinted forms to create 
the final document. With APU, you can eliminate the need for preprinted forms. 
Instead, you create a completely electronic document. With APU, you can: 

* Create multi-copy documents, with each page customized 


* Use data that is contained within a page to determine which of multiple output 
formats to use 


* Remap any field that the input SCS pages contain (change position, font, 
orientation, color, and so on) 


* Print application data in any of the standard bar code symbologies 

* Add document elements such as electronic forms (overlays), images, lines, boxes, 
and constant text 

* Place a new application into production for automatic processing 

* Manage the production of input and output files, including the routing of 
different output files to different queues, printers, and output bins 


* Implement user-defined programs that can address unique document or 
document distribution requirements 


APU provides an interactive interface for defining new output applications. For 
simpler applications, APU provides a “fast path”. You use the current spooled file 
(SCS) interactively to redefine the formatting of application data. 
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Why Use APU? 


APU assists you in building AFP-compatible electronic output. Effective electronic 
output can provide significant benefits to an organization, particularly in the areas 
of information systems costs, process reengineering, and better communications, 
for example: 


* Replacing preprinted multipart forms with electronic forms supplies significant 
cost savings. 


— You can print a variety of different forms one after the other without 
switching forms at the printer. 


— You can eliminate carbon forms by printing multiple copies of the same page, 
that includes the capability of varying the output on each copy. 


— You can eliminate storage space for preprinted forms because the forms are 
stored electronically rather than physically occupying office space. 


— You can change the form outside of the application program, and you do not 
need to scrap or reorder preprinted forms. 


* Documents, whether printed, stored, or viewed, are critical to the workflow in 
any organization. The capabilities of electronic documents provide a wealth of 
opportunities to reengineer organizational processes. In fact, in many industries, 
document reengineering such as bar coding is a “must.” Coding an electronic 
document with bar code, optical character recognition (OCR), magnetic ink 
character recognition (MICR), and images enables you to easily integrate the 
document into the workflow. 


* Electronic documents are more effective documents. Document elements, such as 
images, text, and overlays, allow you to compose a document that does a better 
job of communicating or marketing. Electronic flexibility, the ability to change a 
document dynamically down to the individual transaction level, provides a wide 
variety of application possibilities. Electronic documents project the image of a 
strong, professional organization. 


For more information about the benefits of AFP, refer to iSeries Guide to AFP and 
PSF. 


Printing with and without APU 


This section describes the situation in environments that do and do not use APU. 


Printing without APU 
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APU provides an application-independent, end-user approach to page and 
document formatting. Without APU, the application programmer can format pages 
using either specifications within the application program or DDS (Data 
Description Specifications), which is external to the application program. 
Formatting within the program (also called internally or program-described) only 
provides for line-oriented pages of output. Formatting with DDS (actually a part of 
the printer file) actually provides for comprehensive AFP pages and documents. 
There are DDS keywords not only for field positioning but also for every 
document element (overlay, image, font, bar code, and so on) found in complex 
application output. 


Both these methods of formatting pages, however, are integrated with the 
application program. This is an advantage when you want to precisely customize 
each page based on logic or data within the program. This is a disadvantage when 
you would like to separate the processing of the application program from the 
complex formatting of each page. This is even a bigger disadvantage if there is no 


access to the application program source code or no programming skills exist 
in-house to implement changes to output pages or documents. 


Printing with APU 


Using APU requires no programming skills, enabling individuals with graphics 
and layout ability to design the appearance of the printed page and to easily make 
changes to printout appearance. 


Note: Exact print results depend on the type of printer you have. Refer to IBM 
Printing Systems: Printer Information, 5544-5750, for the specific capabilities of 
your printer. 


Without AFP and APU, the application programmer codes all of the formatting 
information in the application program or printer file and runs the program to 


generate an output file. The output file is placed on a system spool and directed to 
a printer. 


Output Queues 


/ es 
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Figure 1. Flow of Data Through APU and OS/400 


Figure 1 illustrates the processing flow of APU. There is a design phase and a 
production phase. 


The Design Phase 

The new output application is defined in the design phase, which is done once (or 
when changes are required). You do this interactively. The spooled output file from 
the existing application is retrieved and used in the design process. The output of 
this design phase is a set of formatting rules that are stored in an APU print 
definition. 


Chapter 1. Introducing Advanced Print Utility 5 


The Production Phase 

With the new print application designed, it is ready to be placed into production. 
You define the desired production characteristics to APU. These characteristics 
include how to identify the target spooled file, which print definition to use, what 
user-specific programs should be called during processing, and the disposition of 
both the input and output spooled files. With this information in place, you start 
the APU Monitor. 


The APU Monitor automatically monitors iSeries output queues, looking for the 
specified spooled file. When that target file is identified, it is retrieved and passed 
to the APU print engine. The APU print engine uses the formatting instructions 
contained in the APU print definition to create a new AFP output file and place it 
in an output queue. 


At this point, standard iSeries print management takes over. When the new file is 
to be printed, PSF/400 manages the printing process (including the retrieval and 
management document resources such as overlays, images, and fonts) to an IPDS 
printer. Alternatively, the new print file can be routed through Host Print 
Transform to an HP-PCL printer. 


APU formatting instructions 
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APU enables you to build a print definition, which is a set of instructions for 
formatting the data that is contained in a spooled print file. A print definition can 
contain one or more page formats, enabling you to change formatting instructions 
for different pages in the spooled file. Within the page format, you can define one 
or more copies of each input page. Figure 2] shows the relationship among these 
APU concepts. 


APU Print Definition 


| Copy Copy 


Figure 2. APU Data Structure 


You can specify a single page format in a print definition, if all of the pages in 
your spooled file are formatted in the same way. An application that might require 
only one page format is a one-page form such as an invoice, where all of the fields 
on the form are predefined, and a second page is never required. 


Even though you define only one page format in the print definition, you can still 
use the APU multiple copy function to produce different copies of the same page, 


as would be done with hard copy multipart forms. You can, for example, suppress 
the price on the packing slip and print some inventory control information on the 
packing slip as a bar code. 


When you use APU, each copy can be different. The same data can be printed at a 
different position, and different attributes can be used with each copy. For 
example, the customer address from an invoice can be placed on the right side of 
the first (“original”) copy and on the left side and in a different font on the second 


copy. 
Applications requiring multiple page formats in the print definition might be 
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Pre-Printed Invoice 


Figure 3. APU Concepts 


billing statements that could have so many line items that two pages instead of 
one are required to list all of the items ordered. In this case, you would want to 
define one page format to be used for the first page of each customer bill and 
another page format to be used for those customers requiring a second page. 


To determine what page format is used for each input data page, you define fields 
in the data that can be evaluated by APU. For example, if the input data contains a 
field with “PAGE n OF m’” in it, you can specify that field to APU and have the 
contents of the n and m fields evaluated to determine if a second page format 
should be used. 


Steps in Creating an APU Document 


To create a document that takes advantage of the functions that are provided by 
AFP and APU, you need to perform the tasks shown in Bedard 
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Figure 4. Steps to Creating a Document 


Step 1: Analyzing the Existing Application 


Questions you need to Ask 
The first step in creating a document is to examine the contents of the current 
application program that is output by asking these questions: 


* Is the application currently being printed on preprinted forms? If so, how 
complicated is the information on the preprinted forms? If the preprinted form 
contains only a few boxes and text strings, you might consider using the APU 
functions to include those items in the APU print definition. If the form is 
complex, you should probably use another program, such as the Overlay Utility 
in the Advanced Function Printing Utilities for iSeries program product, to 
create an electronic overlay. For more information, see Chapter 2, “Preparing td 


* Is the application currently being printed on multipart forms? If so, do the forms 
all contain the same information, or is some of the data suppressed on some 
copies? 

* Is the same page format used for all pages in the file? Could you improve the 
appearance of the output by using a different format for pages of different types, 
such as a different layout for the first output page than for subsequent 
continuation pages? 


* If you want to use more than one page format in the AFP output, examine the 
contents of a spooled file that is produced by the application. What information 
is contained in the print data that APU can use to determine which page format 
is to be used for each type of output page? 


* What fonts will you need to produce effective output? 
* Would you like to add any image data to the output? 
* Would you like to add any bar code data to the output? 


* What type of AFP printer will you use to print the job? Some AFP printers do 
not support all of the AFP data stream objects, such as bar codes. Refer to IBM 
Printing Systems: Printer Information, S544-5750, for details about printer 
capabilities. 


Example of Sample Spooled File (Source Input Data) 


An example of the sample spooled file (source input data) that you would use to 
build a print definition is given below: 
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LOS ARBOLES DEL MUNDO SAME 
32483 ARBOL LANE 


MESA VERDE 
IL 54078-9390 
141 31341 1/26/98 2/26/98 
1/26/98 N10 MICHELE GOODACRE 
900 EA 00001200 ARBOLES DEL SUR 45.00 40,500.00 
951 CT 11005011 LASSO RED SEEDS 892.23 48,510.73 
46 DZ 11005014 SCARLET NANTES SEEDS 5.90 271.40 
45 BZ 11005015 CHANTENAY SEEDS 2.19 98.55 
951 PK 11005018 EARLY BANTAM SEEDS .38 361.38 
4 BX 11057893 AFRICAN DAISY, SEEDS 2.35 9.40 
100 EA 31321655 SEMILLAS DEL SUS SOMBEROS 24.95 2,495.00 
1000 BX 56413213 POT POT 7.65 7,650.00 
98 PK 84512023 OREGON SPRING TOMATO SEED .97 95.06 
Thank You ..... 


Because you have ordered 
over $500 of trees this 
year, on your next tree 
order you will receive 
a 10% discount. 
$99,991.52 


2/26/98 $99,991.52 
LOS ARBOLES DEL MUNDO 
32483 ARBOL LANE 
MESA VERDE 
IL 540789390 


Page 


Note: There are some restrictions on the spooled file to be copied. Refer to the 
help text for the copy spool file (CPYSPLF) command for details of these 
restrictions. 


Step 2: Locating Required AFP Resources 


If your application analysis in Step 1 identified required overlays, images, or fonts, 
those print resources need to be available before you can proceed with the APU 
design function. APU does not create these print resources, but other IBM and 


Step 3: Using APU to Create a Print Definition 


After APU is installed, enter “GO QAPU/APU” on a command line to display the 
APU main menu, as shown in 
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a > 


APU IBM Advanced Print Utility 


Select one of the following: 


Build and Test APU Print Definitions 
1. Work with Print Definitions 
2. Work with Spooled Files 


Run APU in Batch Mode 
3. Work with APU Monitor 
4. Start APU Monitor 
5. End APU Monitor 


Configure APU 
6. Set APU Defaults 
7. Work with Fonts 
8. Configure APU Monitor Action 


Selection or command 


F3=Exit F4=Prompt F9=Retrieve F12=Cancel F16=System main menu 
F23=Set initial menu 


Figure 5. APU main menu panel 


Initially, you may need_to set the APU defaults if they were not previously set. For 
more information, see 


Creating a print definition includes defining page formats and defining copies. We 
describe these tasks in the sections that follow. 


Defining Page Formats 

When you create a print definition, you must specify whether the print definition 
will contain one or more page formats. If your print definition will contain only 
one page format, APU uses a fast path to map the spooled file data and define 
other document resources such as overlays and images. 


However, if your print definition will contain multiple page formats, you must 
define the fields in the spooled file that APU can_use to determine ene page 


pul to_use for each page of input data. See a 
pa a detailed description of the panels in APU a a use 


for a oir definition with multiple page formats. 


After you have set up the conditions you want APU to use to select a page format, 
you can then specify the formatting instructions for each output copy. 


Defining Copies 

A page format needs a minimum of one copy. APU provides the first “ORIGINAL 
copy with all related default values. Before you create additional copies, you need 
to define or modify all elements common to all copies. All work that is done on 
the first copy can be reused by any additional copies. 


Step 4: Printing with the Print Definition 
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To test how your application output will appear with the new print definition 
applied, select Work with Spooled Files from the APU Main Menu. On that panel 
you can select an existing spooled file to which you can apply your print 
definition. 


After you specify which print definition to apply, APU creates another spooled file 
and sends it to the output queue that you select. You will probably need to 
experiment some to get the data lined up with the electronic form or to refine the 
conditional tests that APU performs to select page formats. 


When you have completed testing of the print definition, you are ready to put the 
application into production. This involves defining how the production process is 
to work, then starting the APU Monitor. 


Use the Work with APU Monitor option on the APU Main Menu to define how 
the target spooled file is identified, which print definition(s) will be applied, any 
special user-specific processing that should be done, and the disposition of the 
input and output files when production processing completes. 


Once these options are defined, the APU Monitor can be started. Use the Start the 
APU Monitor option on the APU Main Menu. At this point, the production 
process is automatic. When the target spooled file is identified, it is automaticall 
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Chapter 2. Preparing to Use the Advanced Print Utility 


Before building your first APU print definition, review the following installation 
and_ planning considerations: 


APU Prerequisites and Options 


Required 
Print Services Facility for iSeries (PSF for iSeries) is the AFP printing subsystem on 
OS/400. PSF for iSeries is used when AFP print files are to be printed on 
Intelligent Printer Data Stream (IPDS) printers. Since APU creates AFP output, PSF 
for iSeries is required to print APU applications to IPDS printers. AFP output files 
can also be printed on HP-PCL printers by using Host Print Transform (a 
component of OS/400) services. There are performance differences and print 
management differences between IPDS and PCL printing. 


Recommended 


AFP Font Collection provides comprehensive libraries of AFP fonts for use in APU 
applications. Standard document typefaces, such as Helvetica, Times New Roman, 
and Courier, are included in over 48 languages. The font libraries are provided in 
240 dpi (dots per inch), 300 dpi, and outline formats, corresponding to different 
printer resolutions. 


;— A note on Examples 
The examples in this publication assume that you have read and write access 
to the QAPU library and to the resources it contains. You may need to contact 
your system administrator to get this authorization. If the QAPU resources 
have been moved, you may also need to obtain the name of the locally 
defined library name where these resources are stored. 


Optional 


AFP Utilities for iSeries consists of three utilities that complement APU 
applications: 


* Overlay Utility provides the capability to create electronic forms. 


* Print Format Utility enables you to create quick, specialized applications, such 
as bar coded labels. 


* Resource Management Utility assists in managing overlay and image resources. 


Client Access for iSeries, in addition to client/server support, integrates the AFP 
Workbench into the Windows or OS/2 client. This provides full graphical viewing 
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of AFP documents, as well as the ability to search, print, and fax what is viewed. 
In addition, the full AFP Workbench includes the IBM AFP Printer Driver for 


Windows. Use this standard Windows driver to create overlays and page segments 
from any Windows application. 


Non-IBM document product tools, of which many exist, assist you in creating 


fonts, images, and overlays. 


Initial APU Setup 


APU provides for several levels of default print settings: 
* At the APU level 
* At the print definition level 
* At the copy level 
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At these levels, you can set print attributes and environment attributes, such as 


unit of measure, resource libraries, and default font family. 


Note: You cannot set all attributes at all levels. 


Use option 6 (Set APU Defaults) on the APU main menu to display the Set APU 


Defaults panel, which is shown in 


Note: Refer to for some helpful hints on setting APU 


Hi 


defaults. 


Type choices, press Enter. 


Unit of measure... . 
Decimal point character 
Fontafamily: 9 f%-0 4 
Colores tee cece eee tates 
Definition library 

Godes Page 2) a to 
Addl. resource libs. 


Job description... . 
Li branyesece rte tease es 


F3=Exit F4=Prompt F12= 
XN 


Set APU Defaults 


* INCH 


HELVETICA 
*DEFAULT 
QAPU 
T1V10500 
IMAGES 
OVERLAYS 


QYPUJOBD 
*LIBL 


Cancel 


*INCH, *CM, *ROWCOL, *UNITS 
6 10T 5 
Value F4 for List 
*DEFAULT, Value  F4 for List 
Name 
Name F4 for List 
Name 
Name 
Name 
Name 
Name 
Name, *LIBL 


> 


Figure 6. Set APU Defaults panel 


The values that are shown above are the values APU will use unless they are 


superseded at print definition level or copy level print definition or copy level. The 
defaults selected in the example above are: 


Inches for unit of measure 


Helvetica for font family 
APUDATA as the library to store APU print definitions 


T1V10500 as the default code page (this is an international code page) 


* For the Job description, we recommend that you use QYPUJOBD in the QAPU 
library. 


Two additional resource libraries, IMAGES and OVERLAYS, were also selected as 
defaults because APU looks in these libraries for document resources, such as page 
segments and overlays. 


You can specify defaults when you first begin an APU print definition. This 
display is shown in 


i : anew : BN 
Set Print Definition Attributes 
Print Definition ..: SUPER2 
ITB ianiye es ie sn sarees QAPU 


Type choices, press Enter. 


Unit of Measure... . *INCH *INCH, *CM, *ROWCOL, *UNITS 
Default line increment *INPUT  *INCH *INPUT, Value 
Default column inc. . . *INPUT = *INCH * INPUT, Value 
Page length « <<. % 4 . *INPUT = *INCH *INPUT, Value 
Page widthie cd s.cc8 Gos *INPUT = *INCH *INPUT, Value 
Top margin (down)... 0 *INCH 0, Value 
Left margin (across) . 0 *INCH 0, Value 
Page orientation ... 0 *INPUT, 6, 90, 180, 270 
Apply field attributes 1=Yes 
More... 


F3=Exit F12=Cancel F22=Set Units 


le EE ee SS 


Figure 7. Set Print Definition Attributes panel 


Note: When you specify *INPUT for the Page orientation field, APU always 
attempts to create the output in Portrait mode by default. APU attempts to 
perform text rotation according to the values specified for the Page length 
and Page width fields. 


The print definition defaults add page layout attributes such as page size, line and 
column increments, and margins. 


The continuation of the panel is shown in igure 8 on page 14: 
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(e > 


Set Print Definition Attributes 


Print Definition ..: SUPER2 
EVDRat yes. ee ee acess 2 QAPU 


Type choices, press Enter. 


Default font family . .  *APUDFT *APUDFT, Value F4 for List 
Point Size. & . Ye « *CALC *CALC, Value 
Boi vs: e2 sees tewese ae 1=Yes 
Gall iGte ree veere co neareays 1=Yes 
Default: Color s ~ 6. *APUDFT *APUDFT, Value F4 for List 
Addl. resource libs. . Name 
Name 
Name 
Name 
Bottom 


ere F4=Prompt F12=Cancel 


Figure 8. Set Print Definition Attributes panel (Continued) 


When you define a copy, you can specify print attributes at this level as well. You 
can override print attributes or default to the attributes specified at the print 
definition or APU level. 


Font Installation Considerations 


APU installation loads the APU software on to the iSeries and creates the QAPU 
library. During the installation process, APU builds the font database. APU 
provides a standard interface to the fonts on the system and must synchronize its 
database with the actual fonts that are resident on the system. 


If you are adding AFP fonts to your system while you are installing APU, you 
should load the fonts prior to installing APU. If you add font libraries after 
installing APU, you will need to synchronize the font database again. To do this, 
issue the following command to run the synchronization program: 


call qapu/qypusync 


After APU is installed, you can access the APU Main Menu by entering GO 
QAPU/APU. 


Review Document Resource Requirements 
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APU creates complex electronic documents, combining many elements into each 
completed page. The building blocks of these electronic pages are electronic 
overlays, fonts, bar codes, and images (that are called page segments in AFP). The 
example below, output from an invoicing application for the Super Sun Seeds 
Company, illustrates those elements: 


Super 
= Sun 
400 CPU Parkway Seeds Office: 555-499-2367 
Vegetation, NJ 55090 A Growth Company Fax: 555-415-9794 
= bhholiWhohialhohbiothbbolhotihl ~T [ ~T 
LOS ARBOLES DEL MUNDO SAME 
32483 ARBOL LANE a 
MESA VERDE 
IL 65478-9390 
L -- Sold To -- | Ls == Ship Toi == =I 
Cust I i HE i Payment 
Roepe. 1a. Nimben. -2L34t Date; 7/28/95 pare, 8/28/95 
Ship Via: Ship Date: 7/28/95 terms: N10 Salesman: MICHELE GOODACRE 
1000 /BX |56413213|; POT POT 7.65 7,650.00 
45/BZ |11005015| CHANTENAY SEEDS 2219 98.55 
900|EA |00001200| ARBOLES DEL SUR 45.00 40,500.00 
98/PK |84512023|} OREGON SPRING TOMATO SEED 797 95.06 
4|)BX |11057893| AFRICAN DAISY, SEEDS 2.35 9.40 
951|/CT }11005011| LASSO RED SEEDS 892.23] 48,510.73 
46 /|DZ |11005014; SCARLET NANTES SEEDS 5.90 271,40 
100/EA |31321655) SEMILLAS DEL SUS SOMBEROS 24.95 2,495.00 
Thank You..... 
Because almost half of 
your order was Lasso Red 
Seeds, you will receive 
a 10% discount on your 
next order. 
Total Due $99,630.14 
Return this tear-off strip with your payment. Make Checks Payable to: Super Sun Seeds 
Payment is due by: 8/28/95 Amount Due is: $99,630.14 
LOS ARBOLES DEL MUNDO 
32483 ARBOL LANE 
MESA VERDE 
IL 65478-9390 


Figure 9. Super Sun Seeds Invoice 


You will note the many characteristics that make this invoice an effective 
document: 


* Static sections of the page built into an overlay 
* Company logo and accent image 

* Use of a variety of fonts 

* Use of bar coding — POSTNET for the zip code 


The following sections use the Super Sun Seeds example to provide a close look at 


the key resources that comprise APU electronic documents: how they are used on 
the iSeries, how they are created, and how APU works with them. 
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Using Fonts with APU 


The examples in the remainder of this manual use the fonts in the AFP Font 
Collection. You should verify that you have these fonts available before going 
on. Your results may differ depending on the fonts defined on your system. 


APU provides an interface that makes selecting fonts simple. During installation, 
APU determines which fonts (character sets) are on your system and loads them 
into this interface. APU distinguishes between IBM-supplied fonts and your own 
custom fonts. 


Most common fonts are selected by font family, typeface (normal, bold, italic, and 
combinations), and point size. This is how APU selects fonts for your document. 
You can select fonts for constant text or for text from the application. The example 
below shows how to map application data to a new font. 


To follow the examples provided in the remaining sections of this chapter, you will 
need a print definition and a ampre spoos file. 


how to select a fine ae file eiled INVPRE. 
Select option 12 (Work with...). 


Select option 10 (Define) on the Work with Copies panel and then select Define 
field mapping on the Define a Copy panel to have the Define Field Mapping 
panel appear. 


From the Define Field Mapping panel, use F14 to mark the beginning of the 
“Improved Printing Corp.” field and F15 to mark the end of the field. Once you 
have taken these two steps, the Select Function panel appears. 


a 
Define Field Mapping >) 
Spooled file ....:  INVPRE Page/iness soso ea TEE 
Controls. 2 1s Sas Columns: ss secs SF 1 - 78 
Re roractisrctareibonetare trey arcnciue ey seecti cancun yadererecticnenerice + oncuiaveser Oise: cust atarsea Oicrsners te anerstsviscre sess teceeta 


Select Function 


From Row / Column : l2/ 2 
engthic cy. = sce G3 22 
Type option, press Enter. 
1=Select 
IMPROVED PRINTING CORP : Opt Function 
PERFORMANCE BOULEVARD 
PRINTERSVILLE : 1 Map as Text 
CO 45789-2637 ‘ Map as Bar Code 
: Suppress 
F3=Exit F1l=Hide mapping : F12=Cancel 
F15=End field F16=Delete range 


Mark endiot field. press PIS on press: (Bs cciss-cieccrsareerescyesecorsre-s.overstecece'e’evere.euee.sierees 


Figure 10. Select Field for Mapping panel 
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Select Map as Text to change the font that is used for the name. The Map Text 
panel appears. 


(— rao » 
Define Field Mapping 
Spooled file .... :  INVPRE Page/Line «2.04 3. 2 I/2 
Map Text 

Type choices, press Enter. 
From Row / Column : 12/2 
Mapping’; «46 <4 tos al 
Length: (ss s&s 22 
Position across . . Led * INCH Value 
Position down... 2 *INCH Value : 
Font family . ...  *PRIDEF *PRIDEF, Value F4 for list : 

POINb SZ s-% *CALC, Value : 

Bilis ozs vn ce sees 1=Yes 

UG aaCS ee onste 1=Yes 
Rotatdiony <. 53% *DEFAULT *DEFAULT, 0, 90, 180, 270 : 
Colones tpn sess *PRTDEF *PRIDEF, Value F4 for list : 

More...: 
F4=Prompt F12=Cancel 
F22=Set Units 
XX o 


Figure 11. Map Text panel 


Position the cursor on the Font family field, press F4 to have the font database 
displayed, then select the font you want. 


va 
Define Field Mapping a 
Si iecssahera evevevave oval auoras oie 6 otarshevere rs evevereueis /oerorers ssaveistalievate ete; siecovarersaievs avelaveie’e eiavevavers, sjo\erviar eye's 
Ces Select a Font 
FONG amily s%, tce Se ss HELVETICA Name, Generic*, *ALL 
POINE SIZE 4 we 4 & s *ALL Value, *ALL 
Bold) 22 hoe ae one 1=Yes, O=No 
Taq Cr es. ei eeo ee 1=Yes, Q=No 
Type Options, press Enter. 
1=Select 5=Details 
Opt Font family Size Style 
HELVETICA 11 Bold 
HELVETICA 11 =Bold-Italic 
HELVETICA 12. ~=Normal 
HELVETICA 12; Italie 
1 HELVETICA 12 =Bold 
HELVETICA 12. =Bold-Italic i 
More... : 
F5=Refresh  F12=Cancel 
Ae Ata OU EME UTED eR RIE ACH CUS RE S) 


Figure 12. Select a Font panel 


Select Helvetica Bold in 12-point, and press Enter. The Map Text panel appears 
again. 
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ie >) 


Define Field Mapping 
Spooled file ... . 3 INVPRE Page/Pines: eG «6 fd 
Map Text 
Type choices, press Enter. 
From Row / Column : T2052 
Mapping. & . 4 et LP a 
lkengith: 42x % sess 22 
Position across . . ed *INCH Value 
Position down. . . 2 *INCH Value 
Font family . . .. HELVETICA *PRIDEF, Value F4 for list : 
Point SIZ@ 6 as 12 *CALC, Value : 
Boiid. cite. ec au 1 1=Yes 
tahini 1=Yes 
Rotation « . ec. *DEFAULT *DEFAULT, 0, 90, 180, 270 
CONOR ayes. ce ast & *PRTIDEF *PRTIDEF, Value F4 for list:: 
More.. : 
F4=Prompt F12=Cancel 
F22=Set Units 
S a 


Figure 13. Map Text panel 


Outline Fonts 
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The current modification level of the APU enables you to download outline fonts 
to IPDS printers. You must first install the fonts, then update the font database 
(with the call qapu/qypusync command) before you can take advantage of this 
technology. 


Outline fonts are scaleable fonts. A scalable font represents each character by a 
mathematical vector that can resolve or scale the character to any size. The point 
size of outline fonts can be anything from 1 to 999.9. Instead of entering a point 
size, you may enter *CALC to have the system calculate the point size using 
information that is derived from the spooled file. 


When you look at the Work with Fonts panel that includes outline fonts, you will 
see *V in the size field instead of a positive numeric value. The *V indicates that 
the size of the font is variable, and hence that it is an outline font: 


ia = 


Work with Fonts 
Domain 2% 4S es ew $ ALL *USR, *SYS, *ALL 
Type Options, press Enter. 
1=Add 2=Change 4=Delete 5=Details 
Font 

Opt Font family Size Style char. set Code page Domai 
TIMES NEW ROMAN 30 = Bold-Italic CON500TO *DEFAULT *SYS 
TIMES NEW ROMAN 36 ~=Normal CON200Z0 *DEFAULT *SYS 
TIMES NEW ROMAN 36 = Italic CON300Z0 *DEFAULT *SYS 
TIMES NEW ROMAN 36 ~=Bold CON400Z0 *DEFAULT *SYS 
TIMES NEW ROMAN 36 ~=Bold-Italic CON500Z0 *DEFAULT *SYS 
TIMES NEW ROMAN Out] *V_ Normal CZN200 *DEFAULT *SYS 
TIMES NEW ROMAN Out] *V_ Italic CZN300 *DEFAULT *SYS 
TIMES NEW ROMAN Out] *V_ Bold CZN400 *DEFAULT *SYS 
TIMES NEW ROMAN Out] *V_ Bold-Italic CZN500 *DEFAULT *SYS 

F3=Exit F5=Refresh  F12=Cancel 


Figure 14. Work with Fonts panel 


Custom Fonts 
APU enables you to add special or custom fonts. You might use a custom font 
when: 
* A particular font is an organizational standard. 


* You need a unique font for a specific application. For example, a marketing 
document could require large characters that are not found in the standard fonts. 


* You have modified IBM-supplied font resources (character set or code page) to 
change a character bit pattern or code point. 


* You want a special monospaced font for columnar data. 


You can use Type Transformer, an optional part of the AFP Font Collection, and 
various non-IBM font products to build AFP fonts. For example, you can use Type 
Transformer to convert any Adobe Type 1 font to an AFP font. After a font 
resource is built on the client, it can be uploaded and created on iSeries. See 

for detailed instructions on 


To make a new font resource available to APU, add it to the APU font database. 
Use option 7 on the APU Main Menu to select Work with Fonts. 
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- > 


Work with Fonts 
Domain’ ss: 2.4. oS & KALLE *USR, *SYS, *ALL 
Type Options, press Enter. 
1=Add 2=Change 4=Delete 5=Details 
Font 

Opt Font family Size Style char. set Code page Domain 
HELVETICA 9 Bold COH40090 *DEFAULT *SYS 
HELVETICA 9 Bold-Italic COH50090 *DEFAULT *SYS 
HELVETICA 10 orma COH20000 *DEFAULT *SYS 
HELVETICA 10 ~=Italic COH30000 *DEFAULT *SYS 

5 HELVETICA 10 ~=Bold COH40000 *DEFAULT *SYS 
HELVETICA 10 = Bold-Italic COH50000 *DEFAULT *SYS 
HELVETICA 11 orma COH200A0 *DEFAULT *SYS 
HELVETICA 11 Italic COH300A0 *DEFAULT *SYS 
HELVETICA 11 Bold COH400A0 *DEFAULT *SYS 
HELVETICA 11 Bold-Italic COH500A0 *DEFAULT *SYS 
HELVETICA 12 orma COH200B0 *DEFAULT *SYS 
HELVETICA 12. Italic COH300B0 *DEFAULT *SYS 

More... 
F3=Exit F5=Refresh  F12=Cancel 


i a ee 


Figure 15. Work with Fonts panel 


The APU font database is displayed, showing the Helvetica character sets. Select 
option 5 to look at an existing character set record. 

The Display Font Details pop-up panel shows the structure of the font records. 

(— = 


Work with Fonts 


Domavlin= 5: esr, te eo ue fe HALE *USR, *SYS, *ALL 


Display Font Details 


Fontetamisliy2ts) cscs aewoye HELVETICA 
PONE SIZE? ee 10 
SPY Grete Cacsirareak sare Bold 
Font character set .. COH40000 
Text description . . . HELVETICA LATIN1-ROMAN BOLD 10-PT 
Code: pages. ss <%= « *DEFAULT 
Domasiinin sy 45 30 sees cosas *SYS 


Press Enter to continue. 


F12=Cancel 


Figure 16. Display Font Details on Work with Fonts panel 


Character set COH40000 is Helvetica Latin! Roman Bold 10-point. It uses the 
default code page (that is stored in the APU defaults). This is a system font, which 
means that it cannot be changed. Press Enter to return to the Work with Fonts 
panel. 


a _ 


Work with Fonts 
Domain: <, <2. i te: eee SALLE *USR, *SYS, *ALL 
Type Options, press Enter. 
1=Add 2=Change 4=Delete 5=Details 
Font 
Opt Font family Size Style char. set Code page Domain 
1 SPECIAL 
HELVETICA 9 Bold COH40090 *DEFAULT *SYS 
HELVETICA 9 Bold-Italic COH50090 *DEFAULT *SYS 
HELVETICA 10 Norma COH20000 *DEFAULT *SYS 
HELVETICA 10 ~=Italic COH30000 *DEFAULT *SYS 
HELVETICA 10 ~=Bold COH40000 *DEFAULT *SYS 
HELVETICA 10 = Bold-Italic COH50000 *DEFAULT *SYS 
HELVETICA 11 Norma COH200A0 *DEFAULT *SYS 
HELVETICA Ts, Atal COH300A0 *DEFAULT *SYS 
HELVETICA 11 Bold COH400A0 *DEFAULT *SYS 
HELVETICA 11 Bold-Italic COH500A0 *DEFAULT *SYS 
HELVETICA 12 Norma COH200B0 *DEFAULT *SYS 
HELVETICA 12. Italic COH300B0 *DEFAULT *SYS 
More... 
F3=Exit F5=Refresh  F12=Cancel 
& y 
Figure 17. Request Addition of the Special Font 
On the Work with Fonts panel, add a new font family that is called “Special”. 
fe Work with Fonts *) 
DOmaiini eer ucqeeys wecper teers ALLE *USR, *SYS, *ALL 
Type Options, press Enter. 
1=Add 2=Change 4=Delete 5=Details 
Font 
Opt Font family Size Style char. set Code page Domain 
1 SPECIAL 
PBIB Tiatetsrerevevaratarctcscvarcec iver tetas cacteyavePorcrueseysrs tana eaccececvarsewnsters eevee ater tstevcec tere catnese rere rere 
HELVET : Add a Font : 
HELVET : 
HELVET : Type choices, press Enter. 
HELVET : 
HELVET 3: (Font: family 3 0204-05 SPECIAL Value 
HELVET : Point. Size: = sw « 10 Value 
HELVET : BOidi ere tanceenk teen eees 1 1=Yes 
HELVET : TEAC Cae eran can vans 1=Yes 
HELVET : Font character set .. (0440200 Name F4 for list 
HELVET 3 “Code: pages... es. 2 Name F4 for list 
HELVET : 
: F4=Prompt  F12=Cancel 
FS=Exit: F 
NS a4 


Figure 18. Add the Special Font to APU 


Type in the font details for the “Special” font on the Add a Font panel. Press Enter 
to add the “Special” font to the database. 


1 for more details on fonts and font 
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Image Resources 


Image resources are a key component in creating advanced electronic print and 
presentation applications. In some cases, such as with accent images, the purpose 
is to improve the look and effectiveness of output. Images like logos and 
signatures are essential parts of a document. In other image applications, such as 
an integrated check image on bank statements, the image is an actual part of the 
application data. 


Figure 19] shows the image, combined with data from the overlay, that is used for 
the Super Sun Seeds logo. 


A Growth Company 


Figure 19. Super Sun Seeds Logo 


How APU Works with Image Resources 


24 APU User’s Guide 


Images are called page segments in AFP. APU can place page segments anywhere in 
a document. It can place multiple page segments on the same page, and it can 
vary the page segments by page format or copy. 


Select Define Page Segments on the Define a Copy panel, then select 1 (Create) 
on the Define Page Segments panel, press Enter and then press F4 on the Create a 
Page Segment Positioning panel. The Select a Page Segment panel appears. This 
panel is used to select page segments with APU. 


Define Page Segments 


Prin : Select a Page Segment 
Li 

Page Segment ..... *ALL Name, Generic*, *ALL 
Type 


Type Options, press Enter. 
1=Select 
Opt : Page 
il : Opt Segment Text description 


1 STRWNB Strawberry, no box, 300-pel 
SUNLOGO Sun Seeds Logo, 300-pel 
TREENB Tree, no box, 300-pel 


Bottom : 
: F5=Refresh  F12=Cancel ; 


Figure 20. Select a Page Segment panel 


Based on the library specified, APU retrieves all available page segments. Select 
STRWNB, an accent image of a strawberry, for use on the Super Sun Seeds 
invoice. 


‘ 7 > 
Define Page Segments 
Print Definition .. :  MYPRTDEF Page Format. .... : *DEFAULT 
Library cosaevees te TOAPU COPY Yai es ss we | SORTGINAL 


Type options, press Enter. 
1=Create 2=Change 3=Copy 4=Delete 


Position Position Unit of Page 


Opt across down Measure segment 
* INCH 
2.5 6 * INCH STRWNB 


Bottom 


F3=Exit F5=Refresh  F12=Cancel 
Galak at position 2.5/6 created 


Figure 21. Define Page Segments panel 


The Define Page Segments panel shows the page segment positioning for this 
copy. The Super Sun Seeds logo was not selected for the invoice document. 
Instead, this page segment was designed into the overlay, so it does not need to be 
separately placed by APU. 


Note: When you are positioning resources, remember that each resource has its 
own offset. Margin settings are not applied to page segments and overlay 
positions, and APU cannot rotate page segments and overlays. If you want 
to rotate page segments and overlays, you must recreate them in the desired 
rotation, then specify their correct placement on the page relative to the 
original page origin. 
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For example, if you have a page segment in the upper left hand corner of an 8 1/2 
by 11-inch page in portrait mode, and you rotate the entire page 180 degrees, you 
will need to recreate your page segment with a rotation of 180 degrees also. You 
then will need to specify the new position of the rotated page segment relative to 
the original page origin; in this case, the lower right corner of the page. 


Building Image Resources 


Creating page segments for APU print applications involves several steps, from 
scanning the source artwork to creating the page segment object. The steps are: 


1. Scan the source image (ideally, camera-ready artwork). 
2. Touch up the scanned image. 

Many client-based software packages support image editing. 
3. Convert the image file to IOCA format. 


You can use the IBM AFP Printer Driver for Windows to create IOCA page 
segments from any Windows application. Many software packages support 
IOCA format. 


4. Upload the IOCA file to the iSeries. 
5. Compile the page segment object. 


Resource Management Utility (RMU), a module of AFPU, provides a complete 
creation (with resizing and rotation) and printing function for page segments. 


Overlay Resources 
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An electronic form or overlay is a collection of constant or static data that is stored 
as an AFP resource and used primarily in place of preprinted forms. 


An overlay can include some or all of the following elements: 
* Vertical, horizontal, and diagonal rules 
* Rules with different weights and thickness 
* Boxes with and without shading 
* Grids, arcs, and polygons 
* Graphics or image, such as company logos 
* Bar codes 
° Text 
— Different inline directions and character rotations for text 
— Different fonts, including fonts that are not used in the print file 


Note: Elements that are used in an overlay depend on the tool used to create the 


overlay. 
es ane nt ee 


400 CPU Parkway See ds Office: 555-409-2367 
Vegetation, NJ 55090 Fen: 555-415-0704 


A Growth Company 


L -- Sold To -- a L -- Ship To -- a) 

| 

Customer Invoice Invoice Payment 
Ei Nuniber : Date: Date: 


Ship Via: Shipped Date: Terms: Salesman: 


ty uOH Item # Item Description Price Extension 


This invoice overlay designed using IBM AFF Utilities/400 


Figure 22. Super Sun Seeds Invoice 


How APU Works with Overlays 


APU can place overlays on any page, in virtually any location. APU can place 
multiple overlays per page and control the placement of each overlay. APU enables 
you to specify one constant back overlay, that is, print an overlay by itself on a 
page without data (for example, a “terms and conditions” page on the back of an 
invoice). You can use overlays conditionally by varying which overlays print on 
each page format or copy. 


Select Define overlays on the Define a Copy panel and then select 1 (Create) on 


the Define Overlay Positionings panel. Press F4 on the Create an Overlay 
Positioning panel. The Select an Overlay panel appears. 
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Define Overlay Positionings 


Prin: Select an Overlay 
Li 
OVER aa o cota te seer se INV* Name, Generic*, *ALL 
Type : 
1: Type Options, press Enter. 
1=Select 
Opt 


Opt Overlay Text description 


INVOICE INVOICE OVERLAY w/o LOGOS 


A 1 INVALL INVOICE: ALL ON ONE PAGE 
dies INVBAC SUPER SUN SEEDS T&C. 
: INVFST INVOICE: FIRST PAGE 
Pass INVHEAD INVOICE: FULL HEADER 
Pets INVHEAD2 INVOICE: MIDDLE PAGE HEADER 
Ons INVLST INVOICE: LAST PAGE 
p INVMID INVOICE: MIDDLE PAGE ; 
More... : 
F : F5=Refresh  F12=Cancel 
Ne J 


Figure 23. Select an Overlay panel 


Select the INVALL overlay. The Define Overlay Positionings panel reappears. 


a 
Define Overlay Positionings . 
Print Definition .. :  MYPRTDEF Page Format... .. :  *DEFAULT 
Vb rainy aa. tae orc © “OAPU COPY seeds Seiad eet *ORIGINAL 


Type options, press Enter. 
1=Create 2=Change 3=Copy 4=Delete 


Position Position Unit of 


Opt across down measure Overlay 
* INCH 
0 0 * INCH INVALL 


Bottom 


F3=Exit F5=Refresh F12=Cancel 


Figure 24. Define Overlay Positionings panel 


The Define Overlay Positionings panel summarizes which overlays are used for 
this copy. After you have defined the overlay, return to the Define a Copy panel 
and select Set Page Layout Options. 


At the copy level using the Set Page Layout Options panel, define a constant back 
overlay. In this case, enter INVBAC as the overlay. 


ie _ 


Set Page Layout Options 


Print Definition .. .  MYPRTDEF Page Format. .... :  *DEFAULT 
[ETI DRAN View ce ea) seeeese = QAPU COPYs os ses eee © KORTGINAL 


Type choices, press Enter. 


Input drawer ..... *DEFAULT *DEFAULT, 1, 2, 3, 4 
Default line increment *PRTIDEF *CM *PRIDEF, *INPUT, Value 
Default Column inc... *PRTIDEF »*CM *PRIDEF, *INPUT, Value 
Page length. ..... *PRTIDEF *CM *PRTIDEF, *INPUT, Value 
Pages width) <3. 4 *PRTIDEF *CM *PRTIDEF, *INPUT, Value 
Top margin (down) . . .  *PRIDEF *CM *PRTIDEF, 0, Value 
Left margin (across) . *PRTDEF *CM *PRTIDEF, 0, Value 
Page orientation ... *PRIDEF *PRIDEF, *INPUT, 0, 90... 
Duplex printing. ... l=Yes, 2=Tumble 
Back overlay ..... INVBAC *NONE, Name F4 for list 
Position across . . 0 *CM 0, Value 
Position down . . . » 0 *CM 0, Value 


Case F4=Prompt F12=Cancel F22=Set Units 


Figure 25. Page Layout Options - Copy Level 


Note: When you specify *INPUT for the “Page orientation” field, APU always 
attempts to create the output in Portrait mode by default. APU attempts to 
perform rotation according to the values specified for the “Page length” and 
“Page width” fields. 


Building Overlay Resources 


IBM provides many alternatives for creating electronic overlays to be used in AFP 
printing applications. The options differ both in cost and in function. You must 
evaluate your requirements to select what best suits your needs. 


Some of the options available include: 

* Overlay Utility, part of AFP Utilities for iSeries 

* IBM AFP Printer Driver for Windows, part of Client Access for iSeries (and 
available separately as well) 

* PC-based forms design programs, such as IBM’s Infoprint Designer and those 
provided by ISIS, ELIXIR, and TRANSFORM/400 

* Forms transferred from other systems 

* Overlay services from IBM and other companies 


See [Appendix D, “A Resource 7A for additional 


instructions on creating overlays. 


Bar Code Resources 


Using bar codes enables you to turn standard printed documents into readable and 
scannable transactions. For example, you can encode data with a bar code to be 
used in your application flow. In many cases, bar coding is becoming a 
requirement in business documents (such as POSTNET for zip codes) and for 
various vendor and supplier applications. 


Bar codes represent characters by using sets of parallel bars of varying width and 
separation or varying heights. Combinations of bars and spaces form individual 


characters, which in turn represent a numeric or alphanumeric symbol that may be 
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a product, part, or publication number. Bar codes are designed to be read by a 
device called a bar code reader or scanner. The scanner must be compatible with 
the printed bar code symbology. 


The following sections show examples of two bar codes: Code 3 of 9 and 
POSTNET. 


Code 3 of 9 Bar Code Example 


Code 3 of 9 is a discrete bar code symbology because each character stands by 
itself and is separated from the others by a non-data space or intercharacter gap. 
Code 3 of 9 is constructed so that each character has 9 elements (count both bars 
and spaces, but do not count the intercharacter gap) with 3 of those elements being 
wide. 


Figure 26] shows an example of the Code 3 of 9 bar code symbology. 
Code 3 of 9 


123ABC789Z 


Figure 26. Code 3 of 9 Bar Code Example 


POSTNET (Postal Bar Code) Bar Code Example 


The POSTNET bar code uses five bars to represent a digit. The data is based on 
the height of the bars instead of on their width. This symbology requires a check 
digit or a correction digit. POSTNET is a numeric bar code only with each digit 
that has 2 tall bars and 3 short bars. 


Figure 27] shows an example of the POSTNET bar code symbology. 


POSTNET ZIP 
PPTL LET LETT Lee Ce Pee 


Figure 27. POSTNET Bar Code Example 


How APU Works with Bar Codes 


APU provides comprehensive support for bar codes: 

* Printing application data or constant data in bar code format 

* Handling the 12 major bar code symbologies and their variations 

* Full control over size and positioning 

* Handling the special attributes of each bar code, such as human-readable 
information and check digits 


In the following example, the zip code is remapped into a POSTNET bar code. 
From the Define Field Mapping panel, use F14 to mark the beginning of the zip 
code field and F15 to mark the end of the zip code field, then press Enter. The 
Select function pop-up panel appears. Select Map as Bar Code to see the 
following panel. 
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You can specify the positioning, rotation, and color used for the bar code. Bar code 
data is displayed only on the Map Bar Code panel. 


(a 5 


Map Bar Code 


Type choices, press Enter. 


From Row / Column : 15 / 16 

Bar code data. .: 45789-2637 

Position across . . £35, * INCH Value 

Position down... 25333 * INCH Value 

Rotation . 4 «4 3 *DEFAULT *DEFAULT, 0, 90, 180, 270 
Colonie aise *PRIDEF *PRIDEF, Value F4 for list 
Bar code type... Value F4 for list 


More... 
F4=Prompt F12=Cancel 
F22=Set Units 


Figure 28. Map Bar Code panel 


Press F4 to display the Select a Bar Code Type panel, which shows the 12 major 
bar codes supported by APU. 


a >) 


Ptotetatarereenereteterstenctersss ‘ Select a Bar Code Type 


Type option, press Enter. 
Type choices, p: 1=Select 


From Row / Colu : Opt Number Text description 
Bar code data . : 


Industrial 2-of-5 
Matrix 2-of-5 
Interleaved 2-of-5, AIM USS-I 2/5 

10 Codeabar, 2-of-7, AIM USS-Codeabar 

11 Code 128, AIM USS-128 

1 12 POSTNET 

F4=Prompt 7 Bottom 
F12=Cancel 


Bar code type . : 


1 Code 39 (3 of 9 Code), AIM USS-39 
Position across : 2 MSI (modified Plessey code) 
Position down . : 3 UPC/CGPC Version A 

4 UPC/CGPC Version E 
Rotation <4 % 5 EAN-8 (Includes Jan-short) 
Color as 6 Se 6 EAN-13 (Includes Jan-standard) 

; i 
8 
9 


: Bar code type re : 


Figure 29. Select a Bar Code Type panel 


Select POSTNET. The Map Bar Code Field panel reappears. Scroll down on this 
panel to see the additional bar code attributes shown below. 
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Map Bar Code 

Type choices, press Enter. 

Bar code type. .: 12 - POSTNET 

Bar code data . . : 457892637 

Length w 22% & +s 9 1-50 

POSTNET Type ... 2 1=ZIP Code, 
2=ZIP+4 Code, 
3=Advanced Bar Code, 
4=Variable length data 


Bottom 
F12=Cancel 


Figure 30. Additional Bar Code Attributes 
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Part 2. Creating Print Definitions with APU 
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Chapter 3. Building an APU Print Definition for a Single Page 


Format 


This chapter provides you with a detailed procedure you use to develop a print 


definition on OS/400 for a single-page document. Here is a summary of the steps 


described in this chapter: 
a 


definitions. 


Example of a Single-Page Format Document 


Following are two illustrations. 


Xa C ed fe 
transformed into an AFP file by APU 


Example of the SCS File to be Formatted 


IMPROVED PRINTING CORP SAME 
PERFORMANCE BOULEVARD 
PRINTERSVILLE 
CO 45789-2637 
100 31300 1/26/98 2/26/98 
BEST WAY 1/26/98 NET 30 YOUR PRINTER REP 
1 CT 00000300 HIGH ALTITUDE WATERMELON 1.01 1.01 
1 PK 01100517 SPARTAN SEEDS 2.39 2.39 
9 PK 04569870 NORTHERN LITE BLUE SPRUCE 858.32 7,724.88 
12 BX 11005004 BUSH GREEN SEEDS 2.50 30.00 
12 CT 11005011 LASSO RED SEEDS 892.23 10,706.76 
26 PK 11005018 EARLY BANTAM SEEDS 138 9.88 
5 BX 11057893 AFRICAN DAISY, SEEDS 2.35 11.75 
1 PK 15975365 HEAVY OAK 129.09 129.09 
33 BX 32746510 HOPS BREWING LIGHT 1.20 39.60 
6 EA 46578913 SEED SURVEYING SITE 50.00 300.00 
2 BX 56413213 POT POT 7.65 15.30 
80 PK 65412384 SEED SCRUBBER 888.79 71,103.20 
1 PK 84512023 OREGON SPRING TOMATO SEED .97 .97 
2 DZ 96325874 PINEAPPLE-ORANGE SEEDS 1.29 2.58 
11 BX 98412006 BLACK BEAUTY ZUCCHINI 2.30 25.30 
5 EA 98546320 FROZEN JUICE PROCESSOR 109.90 549.50 
Thank You ..... 


Because you have ordered 
over $500 of seeds this 
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shows the SCS file to be transformed 


6 shows the same file after it has been 
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year, on your next seed 
order you will receive 
a 10% discount. 
$90,652.21 


2/26/98 $90,652.21 
IMPROVED PRINTING CORP 
PERFORMANCE BOULEVARD 
PRINTERSVILLE 
CO 457892637 


Example of the Formatted File 
The formatted output that you want to produce is shown in Figure 311 


i Super 
= Sun 


400 CPU Parkway Seeds Office: 555-499-2367 
Vegetation, NJ 55090 ‘A Growth Company Fax: 555-415-9794 
TC 71 
IMPROVED PRINTING CORP SAME 
PERFORMANCE BOULEVARD 
PRINTERSVILLE 
CO 45789-2637 
L -- Sold To -- a L ~ Ship To -- a 
Customer Invoice Invoice Payment 


Number: 200 Number: 32300 ares 2/22/98 p 2/22/98 
Ship Via: BEST WAY Shipped Date: 1/22/98 Terms: NET 30 Salesman: YOUR PRINTER REP 


ate: 


1|cT |00000300| HIGH ALTITUDE WATERMELON 1.01 4,104 
1|PK |01100517| SPARTAN SEEDS 2.39 2.39 
9|PK |04569870| NORTHERN LITE BLUE SPRUCE| 858.32 7,724.88 
12|Bx |11005004| BUSH GREEN SEEDS 2.50 30.00 
12|cT |11005011] LASSO RED SEEDS g92.23| 10,706.76 
26|PK |11005018) EARLY BANTAM SEEDS .38 9.88 
5|BxX |11057893| AFRICAN DAISY, SEEDS 2.35 11.75 
1|/PK |15975365| HEAVY OAK 129.09 129.09 
33/Bx |32746510) HOPS BREWING LIGHT 1.20 39.60 
6|EA |46578913| SEED SURVEYING SITE 50.00 300.00 
2|/BX [56413213] POT POT 7.65 15.30 
80|PK |65412384| SEED SCRUBBER 888.79| 71,103.20 
1/PK |84512023| OREGON SPRING TOMATO SEED .97 -97 
2/DZ |96325874| PINEAPPLE-ORANGE SEEDS 1.29 2.58 
11/Bx |98412006) BLACK BEAUTY ZUCCHINI 2.30 25.30 
5/EA |98546320| FROZEN JUICE PROCESSOR 109.90 549.50 

Thank You... . . 

Because you have ordered 

over $500 of seeds this 

year, on your next seed 

order you will receive 

a 10% discount. 


Total Due 


Return this tear-off strip with your payment. | Make Checks Payable to: Super Sun Seeds 


Payment is due by: 2/22/98 Amount Due is: $90,652.21 
IMPROVED PRINTING CORP 
PERFORMANCE BOULEVARD 
PRINTERSVILLE 
CO 457892637 
Page 1 


Figure 31. Super Sun Seeds Invoice 


Setting up a Basic Print Definition 


This section describes the basic steps involved in setting up a print definition. 


Identifying Resources 


For the following procedure, you will use the following sample resources that are 

included in the QAPU library: 

* An overlay that contains the lines, boxes, and shading that you want on the 
preprinted form. This overlay is called INVALL in the sample in the QAPU 
library. 

* A page segment that contains the company logo. In the samples included in the 
QAPU library, this page segment is called SUNLOGO. 
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Note: The output depends on the fonts that are available on your system. Your 
output may not match the following examples. 


Working with a Print Definition 


1. Type: 
GO QAPU/APU 


on the command line of any OS/400 panel. 
2. APU displays its main menu, as shown in igure 34. 


APU IBM Advanced Print Utility 
Select one of the following: 


Build and Test APU Print Definitions 
1. Work with Print Definitions 
2. Work with Spooled Files 


Run APU in Batch Mode 
3. Work with APU Monitor 
4. Start APU Monitor 
5. End APU Monitor 


Configure APU 
6. Set APU Defaults 
7. Work with Fonts 
8. Configure APU Monitor Action 


Selection or command 
===> ik 


F3=Exit F4=Prompt F9=Retrieve F12=Cancel F16=System main menu 
F23=Set initial menu 


Figure 32. APU Main Menu panel 


3. Select option 1, Work with Print Definitions, from the APU main menu. 
Work with Print Definitions appears, as shown in 


Work with Print Definitions 
DIDMaY oss ye, ts. cane serene QAPU Name, *CURLIB 
Type options, press Enter. 
1=Create 2=Change 3=Copy 4=Delete 5=Display contents 
6=Print contents 7=Rename 10=Define 12=Work with 


Opt Name Text 
1 


Bottom 


F3=Exit F5=Refresh  F12=Cancel 


Figure 33. Work with Print Definitions panel 
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4. 


Type 1 in the option column in the first row, then press Enter to create a new 
print definition, as shown in 


a : : ie ee 
Work with Print Definitions 
Mabranye os. ei ee QAPU Name, *CURLIB 
Type options, press Enter. 
1=Create 2=Change 3=Copy 4=Delete 5=Display contents 
6=Print contents 7=Rename 10=Define 12=Work with 
Opt Name Text 
1 
Create a Print Definition 
Type choices, press Enter. 
Print Definition .. .  SUNSD1 Name 
EqbTaRy ots ce. ae ost oe QAPU Name, *CURLIB 
Multiple page Formats .  *NO *YES, *NO 
MOXES VEe0 ce Ge realest Secs os ce SSS One Page Format 
F12=Cancel 
RS SEXasiaiencccrcheyetcrereccncieiereretorota ereseieie eve rsncreaovereteiuas ove rtetenenessucrtrane eisqetsrerersuemee iene eisieiece nveirtonieey 
2 


Figure 34. Create a Print Definition panel 


5: 


© 


Type the name of the Print Definition. 


Note: Use the TAB key to move from field to field. 
Type or select the name of the library where you want to store the print 
definition. 


Select *NO for the Multiple Page Formats item. 


Note: The application we are using as an illustration only requires a single 
page format. 

Type in a description of the print definition. 

Your entries should look something like those in Figure 34) 

When you have completed all entries, press Enter. The program should return 

you to the previous panel and display a message like this on the bottom, left 

corner: 

Print Definition name in library created 


In addition, when you press Enter on the Create a Print Definition panel, the 
Work with Print Definition panel is refreshed to show SUNSD1 in the list of 
available print definitions. 


Further Defining the Print Definition 
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If you want, at this time you can select option 10 to further define the print 
definition. For example, you can select the spooled file or set print definition 
attributes. 


To further define the print definition: 


1. First, type 10 in the OPT column next to your newly-created_print definition to 
access the Define a Print Definition panel, as shown in Eigue ad 


( >) 


Define a Print Definition 
Print Definition .. :  SUNSD1 
Library: «ss a sx > QAPU 
Type options, press Enter. 
1=Select 
Opt Function 
Select a sample spooled file 
Set print definition attributes 


F3=Exit  F12=Cancel 


/ 
Figure 35. Define a Print Definition panel 
2. At this point, you have two options: 
a. oa a1 to access the Select a sample spooled file panel, as shown in 
ie > 
Select a Sample Spooled File 
Output Queue ..... *QYPUOUTQ Name, *ALL F4 for list 
EeVbrany 2 eee QAPU Name, *LIBL 
WSR, toe a eurse ee ee *ALL Name, *CURRENT, *ALL 
Type choices, press Enter. 
l=Select 5=Display 
File Total 
Opt File Nbr User User Data Queue Sts Pages 
INVPRE il USER1 QYPUOUTQ RDY 7 
1 INVSCS | USER1 QYPUOUTQ RDY 6 
Bottom 
F4=Prompt F5=Refresh  F12=Cancel ) 


Figure 36. Select a Sample Spooled File panel 


This panel allows you to specify a sample SCS spooled file that is to be 
transformed by APU. Type a 1 next to INVSCS to select a sample spool file. 


b. Type a1 next to Set print definition attributes selection to access the panel, 
as how th ice onmpagcal 


Chapter 3. Building an APU Print Definition for a Single Page Format 39 


(a 


Set Print Definition Attributes 


Print Definition SUNSD1 
Library: «22 a = & A QAPU 
Type choices, press Enter. 
Unit of Measure... .  *INCH *INCH, *CM, *ROWCOL, *UNITS 
Default line increment *INPUT  *INCH *INPUT, Value 
Default column inc... *INPUT  *INCH *INPUT, Value 
Page. lengthi << 3. 4) ss *INPUT = *INCH *INPUT, Value 
Pager widthir a3 <4) 4. *INPUT = *INCH *INPUT, Value 
Top margin (down)... 0 *INCH 0, Value 
Left margin (across) 0 *INCH 0, Value 
Page orientation . * INPUT *INPUT, 0, 90, 180, 270 
Apply field attributes 1=Yes 
More... 
F3=Exit F12=Cancel F22=Set Units 
yy 
Figure 37. Set Print Definition Attributes panel 1 
(a a: >» 
Set Print Definition Attributes 
Print Definition SUNSD1 
BS He) ately gh' 2 eles eernsesele ets QAPU 
Type choices, press Enter. 
Default font family. . COURIER LATINI1 *APUDFT, Value F4 for List 
Podnte SaZe: 5. See ws 12 *CALC, Value 
Boilidy @-a-07 ch teeny cane 1=Yes 
MPa oe ee owe oe 1=Yes 
Default Color ss «6 « *APUDFT *APUDFT, Value Fa for List 
Addl. resource libs. Name 
Name 
Name 
Name 
Bottom 
F3=Exit F4=Prompt  F12=Cancel sy 


Figure 38. Set Print Definition Attributes panel 2 


Press Enter until the Work with Print Definitions panel displays. 


Working with Copies 
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A page format needs a minimum of one copy. So, your next step is to examine the 
default values that APU has applied to the first, “ORIGINAL copy and make any 


necessary changes. 


1. Type 12 in the option column in the row 
with Copies panel appears, as shown in 


containing en and the Work 


ie ~ 


Work with Copies 


Print Definition .. SUNSD1 Page: Format: 2.2. 4) 3: *DEFAULT 
ITD Raise se) ten aoe QAPU 


Type options, press Enter. 
1=Create 2=Change 3=Copy 4=Delete 7=Rename 
10=Define 


Opt Name Text 
*ORIGINAL Original (first copy) 


Bottom 


es F5=Refresh  F12=Cancel 


Figure 39. Work with Copies panel 


You do not need to create or name a page format; APU does that for you, 
naming the page format *DEFAULT. APU automatically creates the first copy in 
the page format and names it “ORIGINAL. You can rename it by selecting the 
rename option or leave it as it is. 

2. To begin defining the contents of the copy, type 10 in the option column in the 
row that contains the name *ORIGINAL. Pressing Enter displays the Define a 
Copy panel, as shown in 


ta ~ 
Define a Copy 
Print Definition .. SUNSD1 Page Format. .... *DEFAULT 
EbRanyors 3 be, haces QAPU COPY sae ap ee ene an *ORIGINAL 


Type options, press Enter. 
1=Select 


Opt Function 


Select a sample spooled file 
Set page layout options 
Define field mapping 

Define constants 

Define boxes 

Define page segments 

Define overlays 


F3=Exit F12=Cancel 
Be 


Figure 40. Define a Copy panel 


You will use several options on this panel to define the formatting instructions for 
your output: 


* You could use the Select a sample spooled file option to specify the name of 


the spooled file that contains the output of the billing application, but since you 
already specified this file in step bacanacedd you can skip this step. 
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* Select Set page layout options to specify the page size, orientation, and margins, 
as described in 


* Select Define overlays to name the overlay that you want merged with the 
application data on the page. 


* Select Define page segments to include the company logo in the output. 
* Select Define field mapping to map spooled file data to the output page. 


Most of these steps are illustrated below. You can perform the steps in any order, 
as long as you select a sample spooled file first. 


Selecting a Sample Spooled File 


Use the Select a sample spooled file option to specify the name of the spooled file 
that contains the output of the billing application. 


Note: This action was performed previously in step ba on page 34, This can be 
used to make changes to existing print definitions, rather than using the 
Define option. 


Page Layout Options 
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To set page layout options, type 1 next to that option to display the panel that is 
shown in This panel enables you to define page layout options for the 
*ORIGINAL copy. These options include input drawer for this copy, page 
dimensions and options, and the use of a constant back overlay (back side overlay 
without application data). 


( Set Page Layout Options *) 

Print Definition .. .  SUNSD1 Page Format... . . :  *DEFAULT 
[ib Ra Rye yi ae sn oe ees QAPU COPY sk. ese ceo: |= -XORIGINAL 

Type choices, press Enter. 

Input drawer ..... *DEFAULT *DEFAULT, 1, 2, 3, 4 

Default line increment *PRTIDEF *INCH *PRIDEF, *INPUT, Value 

Default Column inc. . . *PRTIDEF *INCH *PRTIDEF, *INPUT, Value 

Page: length 2 s0.v0%. 11 *INCH *PRIDEF, *INPUT, Value 

Page width ...... 8.5 *INCH *PRTIDEF, *INPUT, Value 

Top margin (down)... 0 *INCH *PRTIDEF, 0, Value 

Left margin (across) . 0 *INCH *PRTIDEF, 0, Value 

Page orientation 0 *PRTIDEF, *INPUT, 0, 90... 

Duplex printing... . 1=Yes, 2=Tumble 

Back overlay 25, 2 % *NONE *NONE, Name F4 for list 
Position: across. ss * INCH 0, Value 
Position down. ... *INCH 0, Value 

F3=Exit F4=Prompt  F12=Cancel F22=Set Units 


Figure 41. Set Page Layout Options panel 


Page Layout Options You can Set 
You can specify the following page layout options: 


* The input drawer from which the paper is to be drawn 


* Line and column increments for this page, such as six lines per inch for each line 
and ten characters per inch for each column 


* Page length and width 
* Page margins and orientation; in this example, all zeroes 


Setting up Duplexing 
Notice that you can specify duplex printing. 


You need to be aware of the capabilities and limitations of duplex printing: 
What Duplex Printing Does 


1. Type 1 in the duplex printing field if you want simple duplex printing. The 
result will be that all second pages of the copy will be printed on the back side 
of the page. Enter a 2 to select tumble duplex. 

Restrictions 


2. Duplex printing can be done only for consecutive pages of the same copy. If 
more than one “copy” for a page format is required, duplex printing cannot 
be done because one copy never has two consecutive pages. 

3. If duplex printing is enabled (=1), then the Back Overlay field must be given a 
value of *NONE, because you cannot print both an overlay and print text on 
the back side. 


Note: Refer to Duplex” on page 113) for some helpful hints on using duplex 


printing. 


Defining Page Segments 


Select the Define Page Segments option to name and position the page segment 
that contains the company logo. The Define Page Segments panel is shown, as 


seen in 
ia 
Define Page Segments ) 
Print definition .. SUNSD1 Page format. .... *DEFAULT 
Library. 2 secs 3 QAPU CODY eraate ce cere Nees *ORIGINAL 


Type options, press Enter. 
1=Create 2=Change 3=Copy 4=Delete 


Position Position Unit of Page 
Opt across Down measure Segment 
1 * INCH 


ee F5=Refresh  F12=Cancel 


Figure 42. Define Page Segment panel 


Select option 1 to name a new page segment, then press Enter. Type the name of 


the pase —— STRWNB, and position it at the bottom of the page, as shown in 
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(~ Define Page Segments > 
Print Definition .. :  SUNSD1 Page Format. .... :  *DEFAULT 

Library «2c. n Ss A QAPU Copy a. eae es & “ORIGINAL 
Type options, press Enter. 

l=Create 2=Change 3=Copy 4=Delete 
Position Position Unit of Page 

Opt across down measure segment 

1 *INCH 

Create a Page Segment Positioning 
Type choices, press Enter. 


Position) across:. 3... 3.6 *INCH Value 
Position down. .... 9 *INCH Value 
Page segment ..... STRWNB Name F4 for list 
F4=Prompt F12=Cancel F22=Set Units 
aS 4 


Figure 43. Create Page Segment Positioning panel 


Defining Overlays 


Select the Define overlays option to name and position the overlay that you want 
to use to ‘aoe the preprinted form. The Define Overlay Positionings panel is 


shown in 
(= 
Define Overlay Positionings > 
Print Definition .. SUNSD1 Page Format. .... *DEFAULT 
[TID Ray: es ee ce one QAPU COP ye Geeec ames etn ete *ORIGINAL 


Type options, press Enter. 
1=Create 2=Change 3=Copy 4=Delete 


Position Position Unit of 
Opt across down measure Overlay 
1 


aaa F5=Refresh  F12=Cancel 


Figure 44. Define Overlay Positioning panel 


Select option 1 to name a new overlay, then press Enter. Type the name of the 
overlay, INVALL, and where you want its top left corner to be positioned relative 
to the top left corner of the paper. Note the size of your overlay. If an overlay is 


too_big, PSF for iSeries issues an error message when the job is printed, as shown 
in fee 45 on page 45] 
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Va 


Print Definition 
WETID VARY: oo? ten artes exe os 


1=Create 2=Change 


Position Position 
Opt across down 


Position down. ... 
Overlay <3. = = %< 


POSItTON aACKOSS: «6. 4. 


F4=Prompt F12=Cancel 


Define Overlay Positionings 


SUNSD1 Page Format... . . :  *DEFAULT 
QAPU COPyst wey tesa royce ros ene *ORIGINAL 


Type options, press Enter. 
3=Copy 4=Delete 


Unit of 
measure Overlay 


Create an Overlay Positioning 


Type choices, press Enter. 


0 *INCH Value 
: 0 *INCH Value 
< INVALL Name F4 for list 


F22=Set Units 


Figure 45. Create an Overlay Positioning panel 


If you want to use an overlay that is smaller than the page, you can change its 
location using the Position across and Position down fields. Assume that this 
overlay, INVALL, is designed to fill the whole page and should therefore be 
positioned at the origin of the paper (0,0). 


Mapping Field Data 


Select the Define Field Mapping option to begin mapping the 
the output page. The Define Field Mapping panel is shown in 


Note: Refer to 


Peart file data to 


2} for some helpful hints on mapping 


data. 
(a ae : 
Define Field Mapping 
Spooled file ....:  INVSCS Page/Line's <3 stews Sl/dl 
Gontrolll 22%. 46 ee ea es +10 Columns.) es Ale aS 1 - 78 
Perecesack severe dbeernarh naverticicrsviy tale nete a lagatelecttrerste Aaa actin sievsOevaleastis seca eiO le wicvectiausrsvath efe seek stave 
IMPROVED PRINTING CORP SAME 
PERFORMANCE BOULEVARD 
PRINTERSVILLE 
CO 45789-2637 
100 31300 1/22/98 2/22/98 
BEST WAY 1/22/98 NET 30 YOUR PRINTER RE 
1 CT 00000300 HIGH ALTITUDE WATERMELON 1.01 1.01 
1 PK 01100517 SPARTAN SEEDS 2.39 2.39 
9 PK 04569870 NORTHERN LITE BLUE SPRUCE 858.32 7,724.88 
More... 
F3=Exit Fll=Hide mapping F12=Cancel Fl4=Start field 
F15=End field Fl6=Delete range F20=Right 


Figure 46. Define Field Mapping panel 
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Notice that the “header” of the panel displays the spooled file name, the page 
number, the line number, and the line you are currently dealing with (1/12, 2/12, 
and so on), and the number of columns currently displayed. 


To define and map a field: 


1. Position the cursor where you want the field to start in the spooled file and 
press F14. The rest of the line is highlighted. 
2. Position the cursor where you want the field to end and press F15. 
3. After you have defined the end of a field, the Select Function panel (in the 
following example, on the right side of panel) appears. 
In this example, position the cursor under the I in IMPROVED and press F14. 
Then position the cursor under P in CORP and press F15, as shown in 
i Define Field Mapping ») 
Spooled file «2.6. 3 INVSCS Page/ Lines: 20 a ase 3 1/11 
COmb roles) nese sores eas +10 GoullUMNS everceruecar ayer ecaes 1 - 78 
Hee aeciellncin ets cation te bane Biome hainedine cate wcd cca gieOsoachokwleleecet een 
IMPROVED PRINTING CORP SAME 
PERFORMANCE® BOULEVAR® «cre sucrevcts votes eccie perc aitaaeciearuciecrerisieiers 
PRINTERSVILLE : Select Function : 
CO 45789-2637 
From Row / Column : 12 / 12 
ombengthinmserstcun cores: 22 
100 3 : 98 
: Type option, press Enter. : 
BEST WAY : 1=Select : NTER RE 
: Opt Function 
1 CT 00000300 HIGH : 1 Map as Text : 1.01 
1 PK 01100517 SPAR : Map as Bar Code : 2.39 
9 PK 04569870 NORT : Suppress : ,724.88 
: : More... 
F3=Exit Fll=Hide ma : F12=Cancel : ield 
F15=End field FIG=DGICLG “Seccksweu ck vee nae ude mnrewevexeweeeaeet ) 


Figure 47. Select Function display 


You can select from three options on the Select Function display: 


* The Map as Text option enables you to specify formatting attributes and the 
position of the field on the printed page. You can place a field in up to four 


a on_page 49) for a deserption of this capabiliey 

* The Map as Bar Code option enables you to print the field as a bar code. 
The data in this field must match the data you want represented in bar code. 
APU produces the bar code using Bar Code Object Content Architecture 
(BCOCA), which builds the bar code with all needed elements, such as HRI, 
Check Digit, and so on, depending on the bar code type. 


* The Suppress option enables you to prevent the field from being printed. 


Note: All of the original data prints “as is”, unless it is mapped as text, bar code, 


or suppressed. If you want a field to remain where it is, do not do anything 
to it. 


Mapping a Field as Text 


In this example, select option 1 to map the customer name as text. When you select 


Map as Text, the Map Text panel appears, as shown in 
( Define Field Mapping +) 
Spooled file = 2... 3 INVSCS Page/Line: si. se Gs 1/1 
Map Text 
Type choices, press Enter. 
From Row / Column : iz / 12 
Mapping! =< « = 3: ly ae | 
Length: 3.5 tee Se 22 
Position across . . Aleaih * INCH Value 
Position down... 2 * INCH Value 
Font family... . HELVETICA *PRIDEF, Value F4 for list 
RPOING SAZes je. ces 12 *CALC, Value 
BOilidi teense veaen.ser a 1=Yes 
TbalaiGe sn eee 1=Yes 
ROtAtHON aw ss *DEFAULT *DEFAULT, 0, 90, 180, 270 
Colon 2 cm Sie *PRTDEF *PRTIDEF, Value F4 for list 
More... 
F4=Prompt F12=Cancel 
F22=Set Units 
Xe y 


Figure 48. Map Text panel 


In this example, you need to map the customer’s name to print in bold and a 
larger font. This is the area that uses the HELEVTICA font, so you need to select 
that font. You also need to position the field on the page. 


After you press Enter on the Map Text panel, the Define Field Mapping panel is 
updated to show that the field has been mapped, as shown in 


Define Field Mapping 
Spooled file ....:  INVSCS Page/linevs, < to wee L/L 
Controls co tee boos +10 COlUMNS: coi sete Sone 1 - 78 
A eaactinvenetl cre cach wes wrod ctucsyecheiecec sie tomnechiorere ion ere ctu ster are Oisyarerect ara aye lOleterete tevetarede ere te ats 
2222222222222222222222 SAME 
PERFORMANCE BOULEVARD 
PRINTERSVILLE 
CO 45789-2637 
100 31300 1/22/98 2/22/98 
BEST WAY 1/22/98 NET 30 YOUR PRINTER RE 
1 CT 00000300 HIGH ALTITUDE WATERMELON 1.01 1.01 
1 PK 01100517 SPARTAN SEEDS 2.39 2.39 
9 PK 04569870 NORTHERN LITE BLUE SPRUCE 858.32 7,724.88 
More... 
F3=Exit F11l=Hide mapping F12=Cancel Fl4=Start field 
F15=End field F16=Delete range F20=Right 


Figure 49. Define Field Mapping Completed panel 


The field that you just mapped is shown in this panel as a string of 2s. You can use 
the F11 key to toggle between showing the mappings and hiding the mappings, 
which shows only the data. If you need to change the mapping attributes or 
placement, you can position the cursor inside the area shown with 2s and press 
Enter, which displays the Edit Text Mapping panel. 
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When you map a field, the mapping is displayed as follows: 
Table 1. Field Mapping Values 


1s Bar code 
2s Text 
4s Suppression 
1/2s Bar code and text overlapped 
1/4s Bar code and suppression overlapped 
Note: If you want to edit a field you have previously mapped more than once (for 
example, mapping both bar code and text, or both bar code and suppression 
for a field), position the cursor on the mapped field and press Enter. The 
Edit Text Mapping panel appears allowing you to choose which mapping 
you want to edit, as shown in 
. 
Define Field Mapping > 
Spooled file . 4% 2% INVSCS Page/Line = ws. «8, 2 1/1 
Edit Text Mapping 
Type choices, press Enter. 
From Row / Column : 12 / 12 
Mapping). 2.6 =: Lief a 
kength® 2.04c9 ee 22 
Position across . . 1.1 * INCH Value 
Position down... 2 *INCH Value 
Font family.... HELVETICA *PRTIDEF, Value F4 for list 
Podinit *SiZe. os. su 12 *CALC, Value 
Boldt erere acetone: 1 1=Yes 
Tealiicr (ace he tes 1=Yes 
ROLSEWOW ses au e *DEFAULT *DEFAULT, 0, 90, 180, 270 
COlOy 5 oe ww a *PRTIDEF *PRTIDEF, Value F4 for list 
More... : 
F4=Prompt F12=Cancel F15=Repeat ; 
F16=Delete F22=Set Units 


Figure 50. Edit Text Mapping panel 


Using the Repeat Function 
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In addition to changing the formatting attributes and position of the mapped data, 
you can also use the Repeat function on this display to copy the formatting 
attributes from the selected field to other fields. In this example, you want to use 
the same formatting attributes for the three address lines as you did for the 
customer name, so you can press F15 to open the Repeat Text Mapping panel. 


ie > 


Define Field Mapping 
Spooled file «2. 5. 3 INVSCS Pagevinenst 26) setae 1/1 
Edit Text Mapping 
My PEs CHOMCEScalPiietereecratecetere:cre:esavererars s-s\oreiel cce/e svareuers /etave-eieveraiasetevesereievetececere:sisrervierere eee 
f Repeat Text Mapping 5 
From Row / Colum : : 
Mapping... . : From row / column. . : 125/12 : 
Length 2.6 3 # JLength 2.4424. 22 : 
: Position across ...: Tel *INCH 4 
Position across : Position down....: 2 *INCH : 
Position down. : : 
Font family . . : Type choices for repetitions, press Enter. H 
Point size . : : 
Bollidi Gwe sr “Starntimg; mows sass yen cs 13 Value : 
Italic .. . : Number of repetitions . 3 Value f 
Rotation .. « : 
Collon: eos : Starting position down 2.167 * INCH Value 4 
: Line increment .... 0.167 *INCH Value bi 
F4=Prompt : 2 
F16=Delete : F12=Cancel H 
AER LOT ORE EROS CR RESO LENT RRC OPT A oer Te RAPER Sea Peep incae er Sel eed 


Figure 51. Repeat Function of Text Mapping panel 


Using the Repeat Text Mapping panel, you can repeat the text mapping you 
already defined for a field to other lines in the spooled file. To repeat the mapping 
you selected, specify the following on the Repeat Text Mapping panel: 


* The first row in the spooled file that you want to apply the selected mapping to 
(13 in this example) 

* The number of rows that you want the repeated mapping to apply to (3 in this 
example) 

* The vertical print position where you want the first repeated mapping to 
beplaced (2.167 in this example) 

* The spacing between the repeated mappings (0.167 in this example) 


You can continue to map the remainder of the data in the spooled file by using the 
steps that are described in this section. When you have mapped or suppressed all 
of the data in one page of the spooled file, you have completed the print definition 
for this application. 


Note: You can use the Print contents option on the Work with Print Definitions 
panel to see a detailed summary of the mappings you have specified. 


Mapping a Field at Multiple Locations 
APU includes the capability to map or position fields at more than one location. 
This section describes this capability. 


Mapping a Field the First Time 
When you begin to map a field, the “Map Text” panel will inform you that you are 
“Mapping 1/1”: 
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ie > 


Define Field Mapping 
Spooled file ....: INVSCS Pagesine-i, «0G sees Lf 
Map Text 
Type choices, press Enter. 
From Row / Column : T2552 
Mapping’. «ss « % ey aa 
Keng the: ex ec 22 
Position across . . ed *INCH Value 
Position down... 2 *INCH Value 
Font family... . HELVETICA *PRIDEF, Value F4 for list 
Point SIZ@ 6 as 12 *CALC, Value 
BOiid ote. sores aes 1 1=Yes 
Ctalicr ee as 1=Yes 
Rotation ¢ . % a. *DEFAULT *DEFAULT, 0, 90, 180, 270 
Colon Sr oes ot *PRTDEF *PRTIDEF, Value F4 for list 
More... 
F4=Prompt F12=Cancel 
F22=Set Units 
= 4 


Figure 52. Repeat Function of Text Mapping panel 


Mapping a Field to a Second Position 

If you want to place the field at a different position, press the PAGE-DOWN key 
to re-display the above window. This time, however, the screen will say “Mapping 
2/2”: 


iG 
Define Field Mapping ) 


INVSCS Page/Line 3.3 2 1/5 


Edit Text Mapping 


Type choices, press Enter. 


From Row / Column : T2312 
Mapping. ....: 20 /puee 
length: 262s 22 
\ By) 


Figure 53. Mapping a Second Position panel 
Keep pressing Enter to exit. 


Multiple Mapping Restrictions 

The following restrictions apply to the multiple field location mapping function: 

1. You can place the same field at four locations only; that is the first location and 
three additional locations. 

2. You can change the length of the field in the first mapping only. You will not 
be allowed to change the field length for additional locations. Thus, you can 
only set the units for the first location, but not after that. 

3. The F16 (Delete) function will delete all specifications if the first target location 
is shown; otherwise it will only delete one target location (2 to 4). 


Chapter 4. Building an APU Print Definition for Multiple Page 
Formats 


This chapter provides you with a detailed procedure you use to develop a print 
definition with APU for a multiple-page format document. Here is a summary of 
the_steps described in this chapter: 


Example of a Multiple Page Format Document 


The Super Sun Seeds Company has an invoice with simple preprinted forms that 
allows the format of the continuation page to be different from the first page. This 
facilitates, among other things, a full invoicing heading section on page one, and 
an abbreviated heading on the following pages. Shown below is an example of the 
Super Sun Seeds invoice: 
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52 APU User’s Guide 


oe Super 
= Sun 


90|/crT |00000300| HIGH ALTITUDE WATERMELON 1.01 90.90 
550|cT |00000300| HIGH ALTITUDE WATERMELON 1.01 555.50 
100|EA |00001200| ARBOLES DEL SUR 45.00 4,500.00 
25 |EA |00231300| SEED ROASTER OVEN SET £99'.99 4,999.75 
150|PK |04569870| NORTHERN LITE BLUE SPRUCE] 858.32] 28,748.00 

2|Bx |11005000] FAVA SEEDS 3.90 7.80 

2|BX |11005001| PURPLE TEEPEE SEEDS 4.44 8.88 

52 |BxX |11005002| BUSH WAX SEEDS 2.00 104.00 

52|BxX |11005003| KINGHORN WAX SEEDS 2.13 110.76 

8/BX |11005004| BUSH GREEN SEEDS 2.50 20.00 
8/BX |11005005| BLUE LAKE GREEN SEEDS 4.00 32.00 
2|BX |11005006| KINGHORN WAX SEEDS 3.00 6.00 
2)/CT |11005007| VENTURE GREEN SEEDS 1.50 3.00 
100/CT |11005008| NORTHEASTERN POLE SEEDS 1.29 129.00 
100/cT |11005009| KENTUCKY BLUE SEEDS 2.10 210.00 

58|CT }11005010) EARLY DWARF DANISH SEEDS 3.01 174.58 

58/CT |11005011] LASSO RED SEEDS 892.23 51,749.34 

84/EA |11005012| BLUE MAX SAVOY BEANS 23) 103.32 

84 |pz |11005013] MINCOR NANTES CARROT SEED .87 73.08 

10|pz |11005014) SCARLET NANTES SEEDS 5.90 59.00 

5|Dz |11005014) SCARLET NANTES SEEDS 5.90 29.50 

10|Bz |11005015| CHANTENAY SEEDS 2.19 21.90 

63|BZ |11005016] TOUCHON SEEDS 2.83 178.29 

65|Bz |11005016| TOUCHON SEEDS 2.83 183:,.33 

2|PK |11005018| EARLY BANTAM SEEDS 38 +76 

Total Due 


Return this tear-off strip with your payment. 


Make Checks Payable to: 
Payment is due by: H 


Amount Due 


400 CPU Parkway Seeds Office: 555-499-2367 
Vegetation, NJ. 55090 A Growth Company Fax: 555-415-9794 
— 7 TC 7 
ORGANIC GARDEN SUPPLIES ORGANICS-ON-THE-MOVE 
546 PRODUCE WAY 3872 NATURE'S WAY 
GOLDENOATS NOCHEMS ar 
co 94523-4852 AK 49972-5341 li 
L ~ Sold To ~ L + Ship To - a " 
Customer Tnvoice Invoice Payment S aaa eee 
us : 
Nurber 236 Number; 31336 pate. 1/22/98 Date: 2/22/98 _} Company Fax: 555-415-9794 
Ship Via: CLEAN TRK Shipped Date: 1/22/98 Terms:NET 30 Salesman: CHRIS SEEDER iam | 


ORGANICS-ON-THE-MOVE 
3872 NATURE'S WAY 


ERMELON 
ERMELON 


SET 
E SPRUCE 


ps 


SEEDS 
1S 
H SEEDS 


Return this tear-off strip with your payment. 
Payment is due by: 


File Copy 


Total Due 


Make Checks Payable to: 
Amount Due is: 


NOCHEMS ay 

AK 49972-5341 
le Office: 555-499-2367 
Prs22/98 Bum 23/22/98 hh Company Fax: 555-415-9794 
:NET 30 Salesman: CHRIS SEEDER | oa | 


ORGANICS-ON-THE-MOVE 

3872 NATURE'S WAY 

NOCHEMS 

AK 49972-5341 4 


Ie. Ship To 
Pas22v98 pume" —ny22/98 


Date: 
NET 30 Salesman: CHRIS SEEDER 


SEEDS 
1S 
H SEEDS 


Return this tear-off strip with your payment. 
Payment is due by: 


[| 


Total Due 


Amount Due is: 


Page 1 


Packing List 


Figure 54. Super Sun Seeds Invoice - Page 1 


a super 
= Sun 
400 CPU Parkway Seeds Office: 555-499-2367 
Vegetation, NJ. 55090 ik Geowth Company Fax: 555-415-9794 
i 7 T =i 
ORGANIC GARDEN SUPPLIES ORGANICS-ON-THE-MOVE 
546 PRODUCE WAY 3872 NATURE'S WAY 
GOLDENOATS NOCHEMS ar 
co 94523-4852 AK 49972-5341 r 
L ~ Sold To -- a L ~ Ship To | . 
Cust Invoice Invoice Payment Cilio: 598 409-2087 
justomer i 
Nurker 136 Number; 32336 ater 1/22/98 pete. 2/22/98 _b Company Fax: 555-415-9794 
Ship Via: CLEAN TRK Shipped Date: 1/22/98 Terms: NET 30 Salesman: CHRIS SEEDER F | 
ORGANICS-ON-THE-MOVE 
3872 NATURE'S WAY 
2|PK [11005019| NORTHERN PICKLING SEEDS 239 78 Be or 
90/PK |11005020| FRENCH PICKLING SEEDS 2.39) 215.10 AK 49972-5341 
100|BX ]11057893| AFRICAN DAISY, SEEDS 2.35 235.00 F hip Te . 
25|cr |12382910| SUCCATASH SEEDS .38| 9.50 TF Parent IS Office: 555-499-2367 
45|cT |13145340| SOUR GRAPE SEEDS .15) 6.75 | 1/22/98 pate 2/22/98 h Company Fax: 555-415-9794 
10|PT |15789342| BLUE BELLES, BRIGHT BLUE 18.57 185.70 [npp F 
50|PK |15975365| HEAVY OAK 429308} 6,454.50 [eee > Sueeman CHRIS SEEDER mieten 7 
25|EA |31321654| BELLSTAR SEEDS 7.88 197.00 [price | extension | ORGANICS-ON- THE-MOVE 
2|EA |31321654| BELLSTAR SEEDS 7.88 15.76 3872 NATURE'S WAY 
25|pz |32154657| PETERSBURG PALM TREE 34.90] 872.50 | SEEDS 39 NOCHEMS) os 
6|Bz /32165478) BLACK BYED BANANA 3.01 18.06 FEDS 2.39) AR 4997209341 4 
45|Bx |32746510| HOPS BREWING LIGHT 1.20 54.00 EDS 2.35] i Ship To 
10|cr |35456031| SUNNY SUNFLOWER SEEDS 1.23] 12.30 33 c Payment 
50|EA |35715924| SEED SIFTER SET 2,900.00] 45,000.00 115] 1/22/98 pate 2/22/98 
18|EA |40113254| FRESH FRUIT CANNED CANNER) 22.97] 413.46 HT BLUE 18.57 mr 30 Sal 
6|Bx |56413213| PoT PoT 7.65) 45.90 129.09 iad O _Scenmen CHB Is: SEEDER 
1000|PK |64132029| PITLESS PEACH SEEDS 97 970.00 7.88 [| pace | extension | 
500/EA |90978412| TREE TRIMMER TUBING .20 100.00 7.88 
6|cT |94875081) EARLIROUGE TOMATO SEEDS .49| 2.94 REE 34.90 SEEDS 
45|Bx |98412006| BLACK BEAUTY ZUCCHINI 230) 103.50 3.01 EDS 
5|EA |98546320| FROZEN JUICE PROCESSOR 109.90] 549.50 P 1.20] EDS 
REDS 1.23 
2,900.00} 45,000. 
22.97 413. T BLUE 
7.65 45. 
.97] 970. 
-20) 100. 
Total Due “ag 2. EE 
-230 103. 
Return this tear-off strip with your payment. 109.90] 549. br 
Payment is due by: EEDS 
Page 2 
Customer Copy 
Total Due 
Return this tear-off strip with your payment. Make Checks Payable to: Super Sun Seeds fEssoR 
Payment is due by: Amount Due is: 
e Page 2 
File Copy 
Total Due 
Return this tear-off strip with your payment. Make Checks Payable to: Super Sun Seeds 
Payment is due by: Amount Due is: 
eine Page 2 
Packing List 


Figure 55. Super Sun Seeds Invoice - Page 2 
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io Super 
= Sun 
o3 Seeds 
A Growth Company 
Cr 


ORGANIC GARDEN SUPPLIES 
546 PRODUCE WAY 
GOLDENOATS 

CO 94523-4852 


400 CPU Parkway 
Vegetation, NJ 55090 


Office: 555-499-2367 
Fax: 555-415-9794 


ORGANICS-ON-THE-MOVE 
3872 NATURE'S WAY 
NOCHEMS 

AK 49972-5341 


~ Sold To ~ I Lk Saute Sie: 
Customer Invoice Invoice Payment 
Number 136 Number: 32336 Date: 1/22/98 Date. 2/22/98 


Office: 555-499-2367 


Ship Via: CLEAN TRK Shipped Date: 1/22/98 Terms: NET 30 Salesman: CHRIS SEEDER Fax: 555-415-9794 


‘Company 


ORGANICS-ON-THE-MOVE 
3872 NATURE'S WAY 
NOCHEMS 

AK 49972-5341 


c ~ Ship To a or 


1/22/98 payment 2/22/98 


‘S 
: NET 30 Salesman: CHRIS SEEDER | Company 


ORGANICS-ON-THE-MOVE 
3872 NATURE'S WAY 
NOCHEMS 

AK 49972-5341 


Office: 555-499-2367 
Fax: 555-415-9794 


cE ~ Ship To -- a 


Thank You... . 1/22/98 payment 2/22/98 


Because you have ordered 


over $500 of fruit this NET 30 Salesman: CHRIS SEEDER 
year, on your next fruit 
order you will receive 
a 10% discount. 


Total Due 


your payment. Make Checks Payabl 
2/22/98 Amount Due is: 


is tear-off strip ip 

Payment is due by: $147,561.56). . 
ordered 
it this 

xt fruit 
eceive 


ORGANIC GARDEN SUPPLIES 
546 PRODUCE WAY 
GOLDENOATS 

CO 945234852 


Customer Copy Page 3 


Return this tear-off strip with your payment. 


Make Checks Payable to: Super Sun Seeds _ 


Payment is due by: 2/22/98 Amount Due is: $147,561.56]. 


ordered 


ORGANIC GARDEN SUPPLIES 


At this 
546 PRODUCE WAY xt fruit 
GOLDENOATS ‘eceive 
co 945234852 
File Copy Hege 3 
Total Due 


Return this tear-off strip with your payment. | Make Checks Payable to: Super Sun Seeds 
Payment is due by: 2/22/98 Amount Due is: $147,561.56 


ORGANIC GARDEN SUPPLIES 
546 PRODUCE WAY 
GOLDENOATS 

CO 945234852 


Packing List Page 3 


Figure 56. Super Sun Seeds Invoice - Page 3 


Overview of Defining a Multiple Page Format Document 


This section describes the overall set of steps you will take to define a 
multiple-page print definition. The specific procedure is provided beginning in 
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You will need to define two different page formats (one for page one and the 
second for the continuation pages) and then define the various copies within each 
page format. The steps to create the APU print definition are: 


1. 


Create a print definition that is called INVOICE, and specify multiple page 
formats. 


Select a sample spooled file (INVSCS). 


Define print definition attributes, such as unit of measure, page size, margins, 
and so on. 


Define the selection field in the sample spooled file that determines which page 
format to use. The page number is used to differentiate the page formats. 


Define the rules for identifying a page format, based on the selection field. 


Initial Copy for Page Format One 


APU automatically creates the initial copy for page format one (the default name 
for the copy is *ORIGINAL). Define the details of that first copy, as follows: 


1. Specify general page layout options that includes the constant (Terms and 
Conditions) back overlay (INVBAC) 


Map data in the spooled file, such as the zip code to POSTNET bar code. 
Add the constant text Customer Copy at the bottom 
Place page one overlay (INVALL) on front 


ar oN 


Define two additional copies, the packing list copy and file copy, by first 
copying the definition of the *ORIGINAL copy 


6. Change the packing list copy, suppressing pricing information and printing 
Packing List as constant text 


7. Change the file copy, printing File Copy at the bottom 


Continuation Page Format 
At this point, you have defined how page one and its copies will look. Because the 
page format for the continuation pages will have a very similar layout to page one, 
just copy the entire page format. The steps are: 
1. Copy the page one format (PAGE1) to the second or continuation page format 
(PAGEN). 


2. Make the appropriate changes to the copies within this PAGEN format, such as 
changing the front overlay used. 


Working with a Print Definition 


Identifying Resources 

To use the following procedure, you will use the following sample resources that 

are included in the QAPU library: 

* An overlay that contains the lines, boxes, and shading that you want on the 
preprinted form. This overlay is called INVALL in the sample in the QAPU 
library. 

* A page segment that contains the company logo. In the samples that are 
included in the QAPU library, this page segment is called SUNLOGO. 


Starting to Work on a Print Definition 


1. Start from the APU Main Menu. as shown in Figure 57 on page 54: 
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(a 
APU IBM Advanced Print Utility > 


Select one of the following: 
Build and Test APU Print Definitions 
1. Work with Print Definitions 
2. Work with Spooled Files 
Run APU in Batch Mode 
3. Work with APU Monitor 
4. Start APU Monitor 
5. End APU Monitor 
Configure APU 
6. Set APU Defaults 
7. Work with Fonts 
8. Configure APU Monitor Action 
Selection or command 
===> 
F3=Exit F4=Prompt F9=Retrieve F12=Cancel Fl6=System main menu 
F23=Set initial menu 
5798-AF4 (C) COPYRIGHT IBM CORP. 1996, 1997 


Figure 57. APU Main Menu Panel 
2. Select option 1 to create a print definition, as shown in Figure 58 
Va 
Work with Print Definitions ) 
LbraRy scp eee at QAPU Name, *CURLIB 
Type options, press Enter. 
1=Create 2=Change 3=Copy 4=Delete 5=Display contents 
6=Print contents 7=Rename 10=Define 12=Work with 
Opt Name Text 
1 INVOICE 
Create a Print Definition 
Type choices, press Enter. 
Print Definition ... INVOICE Name 
Libranyicur ae scenes QAPU Name, *CURLIB 
Multiple page Formats .  ¥*YES *YES, *NO 
TOXICS es eee Be Super Sun Seeds Invoicing 
F12=Cancel 
FORE XM: rereteves coteve kerctoncvsusrctcseceteveneeuetstersterstcleccusteve tein sreveherelcvey Suaretevenstedercverces ste keuetsiersterte fersts 


Figure 58. Create a Print Definition Panel 


3. From the Work with Print Definitions panel, create a print definition that is 
called INVOICE. Define INVOICE as a print definition with multiple page 
formats, as shown in 


Developing Your Print Definition 
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1. When you have created the INVOICE print definition, select option 10 (Define) 


on the Work with Print Definitions panel to further define your print 
deanidon, sechown ildieuiesianpasaad 


(a 


Library «ce. i SS ee eX QAPU 

Type options, press Enter. 
1=Create 2=Change 3=Copy 
6=Print contents 7=Rename 


4=Delete 
10=Define 


Text 
APU Screen demo 
Super Sun Seeds Invoice 


Opt Name 
APU1 
10 INVOICE 


ee F5=Refresh  F12=Cancel 


Work with Print Definitions 


5=Display contents 
12=Work with 


Name, *CURLIB 


Bottom 


Figure 59. Work with Multiple Page Formats panel 


2. The Define a Print Definition panel displays: 


Ve 


Define a Print Definition 


INVOICE 
QAPU 


Print Definition 
ETD RARYo ss: co eh sts Se 


Type options, press Enter. 
1=Select 


Opt Function 


1 Select a sample spooled file 

1 Set print definition attributes 

1 Define selection fields for page formats 
Define selection rules for page formats 


F3=Exit F12=Cancel 
XK 


Figure 60. Further Define your Print Definition panel 


3. From this panel, indicate that you will select a sample spooled file. You can 
also define the print attributes at the print definition level. 


4. First, select a sample spooled file. In this example, select the output (SCS 
format) called INVSCS, as shown in Tea 
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Select a Sample Spooled File 
Output Queue. .... QYPUOUTQ Name, *ALL F4 for list 
END YAIRY.® soo os- tee eet se we QAPU Name, *LIBL 
WSC ee Reacts we ctomaee *ALL Name, *CURRENT, *ALL 
Type choices, press Enter. 
l=Select 5=Display 
File Total 
Opt File Nbr User User Data Queue Sts Pages 
INVPRE 1 PERELMAN QYPUOUTQ RDY 7 
INVSCS 2 PERELMAN QYPUOUTQ HLD 6 
Bottom 
F4=Prompt F5=Refresh  F12=Cancel 


Figure 61. Select a Sample Spooled File panel 


5. Because the Set print definition attributes option was also selected on the 
Define a Print Definition panel, you are prompted for such attributes_as page 
characteristics, default font family, and resource libraries, as shown in 


a 
Set Print Definition Attributes 
Print Definition INVOICE 
Library . 2 = 4 2% QAPU 


Type choices, press Enter. 


Apply field attributes 1=Yes 


F12=Cancel F22=Set Units 


F3=Exit 
XN 


Unit of Measure. ... *INCH 

Default line increment *INPUT = *INCH *INPUT, Value 
Default column inc. . . *INPUT = *INCH *INPUT, Value 
Page length «3 3.0. a 11 *INCH *INPUT, Value 
Page width ~ .. 3 a 8.5 *INCH *INPUT, Value 
Top margin (down)... 0 *INCH 0, Value 

Left margin (across) . 0 *INCH 0, Value 

Page orientation 0 *INPUT, 0, 90, 


*INCH, *CM, *ROWCOL, *UNITS 


180, 270 


More... 


~ 


Figure 62. Set Print Definition Attributes (Screen 1) panel 


Note: When you specify *INPUT for the Page orientation field, by default APU 
always attempts to create the output in Portrait mode. APU attempts to 


perform rotation according to the values specified for the Page length 


and Page width fields. 


6. Specify *inch for unit of measure. If you use a grid overlay with the input 
spooled file (an overlay that delineates row and columns), you can choose 


*ROWCOL for unit of measure and just specify a row and column position 


when placing document elements. This does not provide the same level of 


precision as the other units, but for most applications it will be much easier. 


7. Page Down to Panel 2 and change the font: 


(e Roe a 
Set Print Definition Attributes 
Print Definition ..: INVOICE 
Library «<3 4 <« « : QAPU 
Type choices, press Enter. 
Default font family .. COURIER LATINI1 *APUDFT, Value F4 for List 
POINE- SIZE: wos « wi 12 *CALC, Value 
[eXoWal A eee: tad fe petit 1=Yes 
Cail Cpe seers cme canr aurea 1=Yes 
Default Color so = a < *APUDFT *APUDFT, Value F4 for List 
Addl. resource libs. . Name 
Name 
Name 
Name 
Bottom 
F3=Exit F4=Prompt  F12=Cancel 


Figure 63. Set Print Definition Attributes (panel 2) panel 


Defining 


Selection Fields 


This is the continuation panel for setting the print definition attributes. After you 
have completed this panel, the Define Selection Fields panel appears. On this 
panel, you can_view the sample spooled file (INVSCS) and define selection fields, 


as shown in 
“4 Tae >) 
Define Selection Fields 
Spooled file «2.4 .. 3 INVSCS Page/Line®.. 6 6 aa 2 cn) 22/48 
Control 2% «© se Gee a -1 GOuUMNS: 505) eos et cee on 2S 1 - 78 
HS cgiactraieisi ol erelaaihiave eis loe auelat ons ig oe everatert arene oll ovaves satis shaved vie neuaths, evass Olateseisttiers aed taeserect ears 
2 PK 11005018 EARLY BANTAM SEEDS 38 .76 
Continued 
Page 1 
More... 
F3=Exit Fll=Hide fields F12=Cancel 
Fl4=Start field F1l5=End field F20=Right 


Figure 64. Define Selection Fields panel 


The sample spooled file, INVSCS, displays. 


1. 


Locate the page number field at the bottom of the first invoice for Organic 
Garden Supplies, and use F14 to mark the beginning of the field (two spaces 
before the “1”) and F15 to mark the end of the field (under the “1”). A pop-up 
panel shows the selected field, and gives it a default name (F.063.073). Note 
that the default name is based on the row and column location of the field, as 
shown in 
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Define Selection Fields 


Spooled Tiley <6. 5 3 INVSCS Page/Hines: wes ns 2749 
Control ce es es Columns: =< se ow ee 1 - 78 
ia rece stony austell ausasuech wi aiet 2 ereier oth oretensiojerore voxtieds teva Werar ace th eserensiO ascverectistevaus Olnstctesticteneteiionsrecsctieects 


Define Selection Field 
Type choices, press Enter. 


Starting Row / Column : 63,/ 73 ; 
Lengthr ws as cers eae 3 Value : 
None Sate cg ice ade eres PAGEN Name 
F12=Cancel 
Page il 
More 
F3=Exit Fll=Hide fields F12=Cancel 
Fl4=Start field F1l5=End field F20=Right 


Mark end of field, press F15 or press F12 to cancel 


Figure 65. Define Selection Field panel 


2. Change the default field name to something more recognizable, such as 
PAGEN. Note that the page number field has changed to 000, indicating that it 
is a defined field, as shown in 


C Define Selection Fields > 
Spooled file ....: INVSCS Page/Lin@:. 3) sai, | 2/48 
Controle Meir easy ches +1 GOUMMNS: steer coast astvep es 1 - 78 
clon rect ityavedl onevarschorencree cea stosticrersse Oicuatercabceceeiee ecaeteth accis fed accrencthieversva izveveveuh socrevcuicareterectitets 
2 PK 11005018 EARLY BANTAM SEEDS 38 76 
Continued 
Page 000 
More... 
F3=Exit Fll=Hide fields F12=Cancel 
Fl4=Start field F1l5=End field F20=Right ) 


Figure 66. Define Selection Fields panel 


3. Press F3 to exit. 
4. Keep pressing Enter until the Work with Print Definition panel displays. 


Working with Copies 
Inside page formats are copies. 


Note: Refer to g 2 
working with copies and page formats. 


1. Select option 12 (Work with) on the Work with Page Formats panel. The Work 


with Copies panel appears. You are now ready to work with the first copy of 
the PAGE1 page format, as shown in Pisum 67 on pace cil 


21 for some helpful hints on 
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a _ 


Work with Copies 


Print Definition .. INVOICE Pageskormat. so, 2% « *DEFAULT 
ISIDRANVAies ease ese QAPU 


Type options, press Enter. 
1=Create 2=Change 3=Copy 4=Delete 7=Rename 


10=Define 
Opt Name Text 
10 = *ORIGINAL Original (first copy) 
Bottom 
F3=Exit F5=Refresh  F12=Cancel 
Ke a7 
Figure 67. Work with Copies panel 
The first copy (“ORIGINAL) of the print definition is automatically created. 
This first copy will be the Customer Copy of the Super Sun Seeds invoice. 
Defining the Page Layout 
1. Select option 10 to define the page layout of this copy, as shown in Figure 69. 
e Define a Copy : 
Print Definition ..: INVOICE Page Format ..... :  *DEFAULT 
Library: sss a: x : QAPU COPY sos ae we XH ~*ORTGINAL 
Type options, press Enter. 
1=Select 


Opt Function 
Select a sample spooled file 
al Set page layout options 
1 Define field mapping 
1 Define constants 
Define boxes 
Define page segments 
1 Define overlays 


F3=Exit F12=Cancel 


Ne eee 


Figure 68. Define a Copy panel 


The Define a Copy panel shows the composition elements that you can define 
for this copy. 


2. Select the following items: 
* Set page layout options 
* Define field mapping 
* Define constants 
* Define overlays 
3. Press Enter. The Set Page Layout Options panel appears, as shown in Figure 69) 
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ie > 


Set Page Layout Options 
Print Definition ... INVOICE Page Format... .. : *DEFAULT 
Library «<< 3 « os QAPU Copy we se aw « «2 % ORIGINAL 
Type choices, press Enter. 
Input drawer ..... *DEFAULT *DEFAULT, 1, 2, 3, 4 
Default line increment *PRIDEF *INCH *PRIDEF, *INPUT, Value 
Default Column inc. . .  »*PRIDEF *INCH *PRTIDEF, *INPUT, Value 
Page length « . 5 s.< *PRTIDEF »*INCH *PRTIDEF, *INPUT, Value 
Pagerwidthiv ws. <4 4 *PRTIDEF »*INCH *PRTIDEF, *INPUT, Value 
Top margin (down) . . . *PRIDEF «INCH *PRTIDEF, 0, Value 
Left margin (across) . *PRTDEF *INCH *PRTIDEF, 0, Value 
Page orientation ... *PRTDEF *PRIDEF, *INPUT, 0, 90... 
Duplex printing... . 1=Yes, 2=Tumble 
Backoverliay 3: <4) s.< *NONE *NONE, Name F4 for list 
Posi tionnacross! 0. % *INCH 0, Value 
Position down. ... *INCH 0, Value 
F3=Exit F4=Prompt  F12=Cancel F22=Set Units 


Figure 69. Set Page Layout Options panel 


Note: When you specify *INPUT for the Page orientation field, by default APU 
always attempts to create the output in Portrait mode. APU attempts to 
perform rotation according to the values specified for the Page length 
and Page width fields. 


Many of these values default to *PRTDEF, which points to values that are set 
for this print definition. However, these values can also be different, which 
means that an individual copy can have different orientation, margins, 
selections, and other characteristics. 


You need to be aware of the capabilities and limitations of duplex printing: 
What Duplex Printing Does 


1. Type 1 in the duplex printing field, if you want simple duplex printing. The 
resultis that all second pages of the copy are printed on the back side of the 
page. If you want tumble duplex, enter 2. 

Restrictions 

2. Duplex printing can be done only for consecutive pages of the same copy. If 
more than one “copy” is required for a page format, duplex printing cannot 
be done because one copy never has two consecutive pages. 

3. If duplex printing is enabled (=1), then the Back Overlay field must be given a 
value of *NONE, because you cannot print both an overlay and print text on 
the back side. 


Note: Refer to EDuplex” an page 113) for some helpful hints on using duplex 


printing. 


Specifying the Back Overlay 
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Note: If you are going to use duplexing, you cannot have a back overlay. 
Specify the Terms and Conditions overlay (INVBAC) as the back overlay. That 
overlay is shown below: 


Mapping Fields 


Terms and Conditions 


The sale of the products described herein shall be govemed by the termsand canditions cantainedin any written cantract 
currently in effect between Buyerand Seller covenngsuch sale, If there isno such contract, then Seller hereby offarsto sell 
such products to Buyaroniyupon tha terms set forth herein 


1 Salles standard prices in affect at thatimeof shipment unll govem the sale of tha products descabedharsin 
Termsot payment on any approvedonder are net thity (30) days fromthe date of invoice unless otherwise spectically 
stated. Ailshioments, unless s pecitically pro vided, shail be f.0.6 placeot manufacture or warehouse location indicated 
hereon, The price includes cast of packaging fordomestic shirrnent, unless othaswise stated. An adaitionaleharge will be 
made fors pecial domestio or ex pork pecking if this invohesgresterexpense. Shipments will be insuredat the expenssot 
the Guyerunless Suyerspecifivaly requests that shiaments not be insured. 


2 Sellerreserves the nght among other remeaieseitherto terminate this contract or suspendfurtherdelivenes under 
itin (he event Buyerfailsto pay forany one shipment whensame becomes ave, Should Buyer's financial responsibility 
ecomeunsatisfactory to Sefer, cash payments or satisfactory secunty may be required by Sellerforfuturedelivenesand 
for goods theretotoredelivered, 


3 In addition to the purchase price, Suyershallpay the Sellerthe amountof all taxes, excises orotherchanges 
(except taxes on or measured by net income) that Seller maybe requiredto pay to any Govemment (national, state or local) 
with sespect to the progiaction, sale or transportation of any product defiveredtherounder, except where the law otherwise 
provides. Sixty (60) days written notfication must be givento make any changesto delivery schedtile 


4 Sallarwarrants that products dali vared haraundar wall conform to the dasenption on tha facaof this aooumant and 
mest any specifications set forth or incorporated by reference herein and will be adequetelycontainsd, packagedand 
fabeledand confosmto any promises and affirmations of tact madeon the eontainerand label. Setlerfuither wacrants any 
such product againstdefects in workmanship or materials which developar becomeeyident within 12(8 months OEM) atter 
shiement of the product by Seller provided Seller's responsibilty under this warranty shall be limited to the repair or if Seller 
soelects the replace mentof the defective productor component theseofand that said waranty is subject to the following 
exceptions and conditions: 


(a) Aititems claimedto be defective must be setmedto Seiler, trans portation chamges prepaid end mill be retumed 
to Buyertransportation chamescolect unless foundte ba detective in which case Sellerwill pay alltransportation 
charges. 


tb) Seller's warranty will not appiyto.tems whichbave been moaifiedor repaired without Seller's wrttanconsent 
by personsotherthan Sellers authorizedservice personnel. 


& itshould be notedthat Seliemas usedthe powe ful toolsofA S400 Advanced Function Pantingto orate Selers 
invoice, and despitethe arcane termsand conditions whichare presently being read, the involve is a very effactive business 
cbcument, day attemgt to martheappearanceot thisinvoice should be discouraged, 


6 The validly, interpretation and performanceof the terms hereof with es peotto any product deliverediorto be 
delivered)hereundershalt be go vemed by the lawrof the State of Goto rade. 


# No modification or waiver of the terms here of shall be bindingugon Selleruniess aperoved in writing byen of 
Seller's Officers or Marketing Managers or shallbe affected by acknowledgment or acceptance of curchase ander forms 
containing otherar different terns whetheror not signediby authonzed'e presentative of Seller. (a) Seflerdoes not warrant 
items which have been damaged due to negligenceor misuse. 


8 THEREA SE NO-EXPAESS WARRANTIES BY SELLER OTHER THAN THOSE SPECIFIED IN THIS 
PARAGRAPH. NO WASRANTIES BY SELLER (OTHER THAN WA GRANTY OF TIFLEAS PAOVIDED IN THE UNIFORM 
COMMERCIAL CODE) SHALL BE IMPLIED OR OTHERWISE CREATED UNDEA THE UNIFORM COMMERCIAL CODE, 
INCLUDING BUT NOT LIMITED TO WARRANTY OF MERCHANTABILITVIN OTHER RESPECTS THAN SPECIFIED IN 
THIS PARAGRAPH AND WARRANTY OF FITNESS FORA PARTICULAR PURPOSE. Withoutlimiting the generaltyot 
the foregoing. Buyer assumes afl risk and lability forthe results obtained by the use of any products deliveredhereunderin 
combination mith other articles or matesiafor in the practice of any process. 


4 NNO CLAIM ofany kind with zespect to any product specified hemin, whetheras ta product dellveredor for 
nondaliveryof productand whetheror not basedon negligence, SHAL! AE GOEATEA JN AMOUNTthan the purchase pice 
ofthe productin respect of which suchckim is made, in no event shalleither party be lable for special indirect or 
consequential damages whatheror not caused by or resuitingtiom the negligenceof such pavty. 


10. It is expressly understoodthat any technical advice fumishedby Sellerwith reterenceto the use of ts products is 
givengratis and Sellerassumes no obligationof fiabiftyfor the advice given or resus obtained, all such advice being given 
and accepted at Buyer's risk 


i inthe event Buyertails to tullll Seller's termsof paymentior the products specified herein, orin caseSeltershall 
have any doubt at anytime as to Buyer's financial responsiblity, Sellermay deciinete maketutherdelveries excest upon 
feceiptof cashor setistactory securty. 


Figure 70. Back Overlay (Terms and Conditions) - INVBAC 


After you have specified the Terms and Conditions overlay, you will then need to 
define field mapping for your output. 


Note: Refer to 


Press F3. The Define Field Mapping panel, shown in Figure 71 on page 64, 


data. 


appears. 


Chapter 4. Building an APU Print Definition for Multiple Page Formats 


2} for some helpful hints on mapping 
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Define Field Mapping 
Spooled file ....:  INVSCS Page/ine:s. .es ee 12741 
Control ce es ee +10 Columns: =. <6 @ 2% 28 1 - 78 
Aioresetuwasvedl cucu a cttyatener Ge reearech cucneresoierersy eaters teach ovararsahieccvan O levcuerectusncvate Olspetarcatrereretei eve soechineate 
ORGANIC GARDEN SUPPLIES ORGANICS-ON-THE-MOVE 
546 PRODUCE WAY 3872 NATURE'S WAY 
GOLDENOATS NOCHEMS 
CO 94523-4852 AK 49972-5341 
136 31336 1/22/98 2/22/98 
CLEAN TRK 1/22/98 NET 30 CHRIS SEEDER 
90 CT 00000300 HIGH ALTITUDE WATERMELON 1.01 90.90 
550 CT 00000300 HIGH ALTITUDE WATERMELON 1.01 555.50 
100 EA 00001200 ARBOLES DEL SUR 45.00 4,500.00 
More... 
F3=Exit F1l=Hide mapping F12=Cancel Fl4=Start field 
F15=End field Fl6=Delete range F20=Right 


Figure 71. Define Field Mapping panel 


APU displays the Super Sun Seeds invoice spooled file for data mapping. With 
data mapping, you can redefine how the application data is to be placed when 
printed. For the example we are using, we will describe the following: 


* Mapping bar codes 

* Defining constant data 
* Defining Fonts 

* Defining overlays 


Note: If you want to map the same field to multiple locations, use the procedure 
that is described in 


Mapping Bar Codes 
This section describes how to map bar codes. 
1. First, the Define Field Mapping panel must be displayed, as shown in 


2. To reprint the zip code in the name and address in POSTNET bar code, you 
first define the zip code field to APU. Use F14 to specify the beginning of the 
field and F15 to specify the end of the field. 

3. Select what you want to do with the zip code field. In this case, map it as bar 
code. 
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Map Bar Code 
Type choices, press Enter. 
From Row / Column : 15 / 16 
Bar code data. .: 94523-4852 
Position across . . Let * INCH Value 
Position down... 1.6 * INCH Value 
Rotation . 3 «4% *DEFAULT *DEFAULT, 0, 90, 180, 270 
Coloring: goa ae aes *PRTDEF *PRTIDEF, Value F4 for list 
Bar code type... 12 Value F4 for list 
More... 

F4=Prompt F12=Cancel 

F22=Set Units 

< Sau Wc eCeio ere Wi Gpetehe vs aie ow ieieioia iniviaie wea) een he i eieay eae ws ei Beevers oremiass Siuieis ansiey cimejeceley sears sive reiniess 3 


Figure 72. Map Bar Code panel 


4. The Map Bar Code panel is a multi-panel pop-up used to select, define, and 
position the bar code. The zip code is at row 15, column 16, and the value is 
shown. Map it (make a copy of the zip code) in bar code to a position starting 
at 1.1 inches down and 1.6 inches across the paper. It could have also been 
positioned by row and column. In either case, it will appear just above the 
name and address. Position the cursor in the Bar code type field and press F4 
to display a list of supported bar code types. 


5. Select 12, which is POSTNET, and Page Down to see additional optional bar 
code type information. 


Note: To successfully print your POSTNET bar code mapping, you must 
specify the correct number of digits (5 or 9, for example) for the type of 
POSTNET bar code you selected. 


Note that non-numeric characters, such as the dash that is contained in the ZIP 
+ 4 code, are removed on the second panel for you. 


6. Press Enter to return to the Define Field Mapping panel. 
7. Press F3. The Define Constants panel appears, as shown in 
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Define Constants 


Print Definition .. INVOICE Page Format. .... *DEFAULT 
ebRaryes oe eda: QAPU COPY ee: Telecast en *ORIGINAL 


Type options, press Enter. 
1=Create 2=Change 3=Copy 4=Delete 


Constant Position Position Unit of 
Opt type across down measure Constant value 
1 *TEXT 


Uieoe F5=Refresh F12=Cancel 


Figure 73. Define Constants panel 


Defining Constant Data 


Next, define the constant text Customer Copy to appear at the bottom of this 
copy.Specify a text type for this constant. You could also specify a constant bar 
code. 


1. Select option 1, enter a constant type of *TEXT, then press Enter. The Create 
Constant Text panel appears, as shown in Figure 74l 


Define Constants 


Create Constant Text 


Type choices, press Enter. 


Position across . . 4.0 *INCH Value 
Position down... 10.8 *INCH Value 
Constant value .. Customer Copy 
FONG? Poser ie a0 *PRTIDEF *PRTIDEF, Value F4 for list 
Pont Size. s,s *CALC, Value 
BOsliGh sens, este cues 1=Yes 
tala ve ha sara. 1=Yes 
Rotation) a0 sss. *DEFAULT *DEFAULT, 0, 90, 180, 270 
COLOR So ek sn Sas *PRTDEF *PRTIDEF, Value F4 for list 


F4=Prompt F12=Cancel F22=Set Units 


Figure 74. Create Constant Text panel 


2. Specify the text Customer Copy and position it 10.8 inches down and 4 inches 
across the paper. 


Selecting Fonts 


1. Position the cursor in the Font field, and press F4. The font database appears. 
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r— Outline Fonts 


APU supplies Outline fonts in addition to other standard IBM fonts. Refer 


2. For this example, select a Helvetica, 10-point, bold font as shown in Figure 75] 


a 
Define Constants +) 
dae Select a Font 
ae Font thamiliy® censor Aes HELVETICA Name, Generic*, *ALL 
seas POURE SIZE: 5.5. sca. 4 *ALL Value, *ALL 
Ss BOUGIy freon Mesa cansucre ts 1=Yes, Q=No 
ar DEO G ceva se esas ae 1=Yes, O=No 
: : Type Options, press Enter. 
an 1=Select 5=Details 
: : Opt Font family Size Style 
cans 1 HELVETICA 10 = Bold 
Raed HELVETICA 10 = Bold-Italic 
2 3 HELVETICA 11 ~=Normal 
Aa HELVETICA ll Ttalic 
Raed HELVETICA 11 =Bold 
cae HELVETICA 11 =Bold-Italic : 
2 More... : 
: : F5=Refresh  F12=Cancel - 
ie save aaron ate nat cua ava orate auctane Tet louae Srers arsetecere eieser overstate sy auar ie) aveveien amieteue acai fava srenenav roars J 


Figure 75. Select a Font panel 


The Select a Font panel is a pop-up panel in which you specify a font family. 
You can manually type point size and type style selections, or you can select 
the font you want from the list of fonts in the bottom half of the display. In 


addition, you can use option 5 to display the details of a specific font. 


3. Press Enter. The Create Constant Text panel reappears. Press Enter. The Define 


Constants panel reappears, as shown in 


Define Constants 


Print Definition .. INVOICE Page Format. .... *DEFAULT 
ETD RaR yee: ce. eases ee QAPU COPY eer cea veces kine *ORIGINAL 


Type options, press Enter. 
1=Create 2=Change 3=Copy 4=Delete 
Constant Position Position Unit of 


Opt type across down measure Constant value 
1 *TEXT 4.0 10.8 * INCH Customer Copy 


aaa F5=Refresh  F12=Cancel 


Figure 76. Define Constants panel 
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Defining Overlays 
1. Press F3. The Define Overlays panel appears, as shown in Figure 77. 


ie 
Define Overlay Positionings >) 
Print Definition «. << INVOICE Page Format. .... : *DEFAULT 
EDA Nr ystemc ot, cetse ee oe QAPU COPY oes awe se 6 XORTGINAL 


Type options, press Enter. 
l=Create 2=Change 3=Copy 4=Delete 
Position Position Unit of 
Opt across down measure Overlay 
1 0 0 *INCH INVALL 
(There are no overlay positionings defined) 


F3=Exit F5=Refresh  F12=Cancel 


Figure 77. Define Overlays panel 


2. On the Define Overlays panel, select the Super Sun Seeds invoice overlay 
(INVALL) to be printed on this copy. A sample of the INVALL overlay is shown 


below: 
Super 
un 
400 CPU Parkway Seeds Office: 555-409-2367 


Fegetation,N/ 55090 Fax: 555-415-0704 


A Growth Company 


L -- Sold To -- a L -- Ship To -- a) 
| | 
Customer Invoice Invoice Payment 
Munber: Nundber : Date: Date: 
Ship Via: Shipped Date: Terms: Salesman: 
Ory = | VOM Item # Item Description Price Extension 


This invoice overlay designed using IBM AFP Utilitiew400 


Figure 78. Sample INVALL Overlay 
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Replicating the Contents of Copies 
At this point, the composition of the customer copy has been defined. Press Enter 
until the Work with Copies panel appears again. 
1. Select option 2 to change the text to Customer copy. 


2. Select option 3 (copy) to replicate the contents of the customer copy to two 
additional copies: the Packing list and the File copy, as shown in Figure 74 


( : : >) 
Work with Copies 
Print Definition ..: INVOICE Page Format . .... : *DEFAULT 
Ribrdnys noe QAPU 
Type options, press Enter. 
l=Create 2=Change 3=Copy 4=Delete 7=Rename 
10=Define 
Opt Name Text 
Di); Gaeatleiatove th tvste svece: susllahctsveeecous nus Spsiereueual etaveveveveyaie stevscste seus rveieiavers acueisiene 
Copy a Copy 
Type choices, press Enter. 
From Page Format .. : *DEFAULT 
From copy... ... :  *ORIGINAL 
To Page Format .... *DEFAULT Name 
TO COPY: <3 x) se ce es FILE Name 
NeW texts oo Hee ete ede File Copy 
F12=Cancel 
F3=Ex 
Co 
Nani y 


Figure 79. Work with Copies panel 


3. Select option 10 to define these copies and change the constant text that is 
printed at the bottom to Packing List and File Copy, respectively. 


4. To suppress the price information on the packing list copy (PACKING), select 
option 10 to define the packing list copy and bring up the sample spooled file 
with the field mapping function. 


5. Use F14 and F15 to mark the first field in a column to be suppressed. In this 


example, the price field and extension field are suppressed from printing, as 
soweinlEoge Signe 7d 
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Define Field Mapping 


Spooled file ....:  INVSCS Pagesiness 28s) 2717. 
Control ca es eee Columns: = <6 ew 8 1 - 78 
Aioresestuw auerval ceva act tere Caerevare teavenenessis reveccshtene ora ch evaratcahieectais 0 leveveroctiorevaus Olsnetcvcctrobaysiei/iave sechantats 
136 31336 1/22/98 2/22/98 
CLEAN TRK 1/22/98 NET 30 CHRIS SEEDER 
90 CT 00000300 HIGH ALTITUDE WATERMELON 444ggggggggggggggagaggg 
550 CT 00000300 HIGH ALTITUDE WATERMELON 1.01 555.50 
100 EA 00001200 ARBOLES DEL SUR 45.00 4,500.00 
25 EA 00231300 SEED ROASTER OVEN SET 199.99 4,999.75 
150 PK 04569870 NORTHERN LITE BLUE SPRUCE 858.32 28,748.00 
2 BX 11005000 FAVA SEEDS 3.90 7.80 
2 BX 11005001 PURPLE TEEPEE SEEDS 4.44 8.88 
52 BX 11005002 BUSH WAX SEEDS 2.00 104.00 
52 BX 11005003 KINGHORN WAX SEEDS Zl 110.76 
More... 
F3=Exit Fll=Hide mapping F12=Cancel Fl4=Start field 


F15=End field F1l6=Delete range F20=Right 
ee Pprese ton at 24/58 created 


Figure 80. Suppression panel 


6. Press Enter. 


7. Select the function to repeat the suppression. In this case, because an invoice 
can contain up to 31 line items _on a page, repeat the suppression 30 times for 
the price field, as shown in Figure sil 


‘s Define Field Mapping 
Spooled file ....:  INVSCS Pages Wines, cs sce te eT. 
Control yts nese sted oes COlUMNS eure cuca eerecues 1 - 78 
Aare cept evaepell cnanrets teers tricte crap chiareerel Sjerevevechtare stacy erences aiect ans OVevene at tevae OlsecneycstreneiedeiMicness echisva ts 
W302 aioe sere ere suaresateis sue. cveueusieys acclepa ev alacers avers einai ave e auanuats guaer@aiers 
Repeat Suppression 
CLEAN 
: From row / column 24 / 58 
siikength: <: 3.20 4% 21 
90 CT 00 : 
550 CT 00 : 
100 EA 00 : Type choices for repetitions, press Enter. 
25 EA 00 : 
150: PK (04: ‘Starting row 2. 3. 2% 25 Value 
2 BX 11 : Number of repetitions . 30 Value 
ZABKe A Nee: 
52eBK er elit 
52BX il, 
F3=Exit : F12=Cancel : 
Fl5=End field Seger nay sesyeretalare or caerveretcaveter vers tei tetavcneterarerete tors ecoene tare tet oer scree ters 


Suppression at 24/5 
S 


Figure 81. Repeating a Suppression panel 


8. Repeat these steps to suppress the extension field. The packing list copy is 
shown below: 


Figure 82. Sample Packing List Showing Suppression 


Super 
sun 
400 CPU Parkway See ds Office: 555-409-2367 
Vegetation, NJ 55090 “4 Groin Comiiaidy Fen 555-415-0704 
ORGANIC GARDEN SUPPLIES ORGANICS -ON-'THE-MOVE 
546 PRODUCE WAY 3872 NATURE'S WAY 
GOLDENOATS NOCHEMS 
jo 94525-4052 [3K age72-e3a2 | 
== Sold To -- == Ship Toa << 
fumber: 136 Numer: 31336 paces 4/09/96 pager’ 5/09/96 
Ship via:CLEAN TRK  shippeapate: 4/09/96 terms:NET 30 Salesman: CHRIS SEEDER 
Oty Uo Item # Item Description Price Extension 
gofcer | 09000300] HIGH ALTITUDE WATERMELON 
550/cr | 00000300] HIGH ALTITUDE WATERMELON 
100/BA | 00001200| ARBOLES DEL SUR 
25/EA | 00231300] SEED ROASTER OVEN SET 
150/PK | 04569870| NORTHERN LITE BLUE SPRUCE 
2}ex | 11005000| FAVA sEEDS 
2/Bx | 11005001] PURPLE TEEPEE SEEDS 
52/px | 11005002] BUSH WAX SEEDS 
52/B% | 11005003] KINGHORN WAX SEEDS 
e|px | 11005004] BUSH GREEN SEEDS 
g|px | 11005005] BLUE LAKE GREEN SEEDS 
2/px | 11005006) KINGHORN WAX SEEDS 
2}er | 11005007] VENTURE GREEN SEEDS 
100}cT | 11005008| NORTHEASTERN POLE SEEDS 
1oo;er | 11005009] KENTUCKY BLUE SEEDS 
se/or | 11005010] BARLY DWARF DANISH SEEDS 
58/cr | 11005011] LASSO RED SEEDS 
84/EaA | 11005012| BLUE MAX SAVOY BEANS 
e4/pz | 11005013) MINCOR NANTES CARROT SEED 
10}pz | 11005014] scARLET NANTES SEEDS 
5|pz | 11005014| SCARLET NANTES SERDS 
10/Bz | 11005015) CHANTENAY SEEDS 
63/Bz | 11005016] ToUCHON SEEDS 
65/Bz | 11005016] TOUCHCON SEEDS 
2}PK | 11005018] BARLY BANTAM SEEDS 
2/PK | 11005019] NORTHERN PICKLING SEEDS 
90;PK | 11005020] FRENCH PICKLING SEEDS 
100/Bx | 11057893] AFRICAN DAISY, SEEDS 
a5;cr | 12362910] succaTASH SEEDS 
45/cr | 13145340] SOUR GRAPE SEEDS 
10;pr | 15789342] BLUE BELLES, BRIGHT BLUE 
50/pK | 15975365] HEAVY CAK 
25/EA | 31321654| BELLSTAR SEEDS 
2|/Ba | 31321654] BELLSTAR SEEDS 


Packing List 


This invoice overlay designed using IBM AFF Utilitiew/400 


Continued 


Page 


1 


Continuation Page Copies 


At this point, you have defined all the copies within the first page format (PAGE1). 


1. 


2. 
3. 
4 


a 


Now, return to the Work with Page Formats panel. 


Rename *DEFAULT to PAGE1. 
Change text to PAGE1 format. 
From this panel, select option 3 to make a copy of the PAGE1 page format, 


copies and all. 


Select option 2 to change the text to Page 1 format. 


ae that the new page format will be called PAGEN, as shown in 
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(e 


Work with Page Formats 


Print Definition INVOICE 
ebRar yes) sos ee ances QAPU 
Type options, press Enter. 
1=Create 2=Change 3=Copy 4=Delete 7=Rename 


12=Work with 
Opt Name 
Copy a Page Format 


Type choices, press Enter. 


From Print Definition : INVOICE 
From Page Format PAGE1 
To Page Format PAGEN Name 
New: TEXt> sh eo, sce Page N Format 
F12=Cancel 
F3=Ex 
RAG Commi isercrcsercteccnoreis ste siereteteachnie exe oaeiereyercie efeietarane sisteue cresetorereveretetateieetsieis sheieie's otetsrenereistels 


Figure 83. Work with Page Formats panel 


7. Press Enter to return to the Work with Page Formats panel, as shown in 


(— : 
Work with Page Formats 
Print Definition INVOICE 
LED diy osabeterences acters QAPU 
Type options, press Enter. 
1=Create 2=Change 3=Copy 4=Delete 7=Rename 
12=Work with 
Opt Name Text 
12 PAGEN Page N Format 
PAGE1 Page 1 Format 
Bottom 
F3=Exit F5=Refresh  F12=Cancel 


ee Page Format PAGE1 to PAGEN 


Figure 84. Work with Page Formats panel 


8. Select option 12 to work with the PAGEN page format. The Work with 
Copies panel appears, as shown in Figure85.on page 74 


é = 


Work with Copies 
Print Definition ..: INVOICE Page Format. .... : PAGEL 
Library «<2 4 « % : QAPU 
Type options, press Enter. 
l=Create 2=Change 3=Copy 4=Delete 7=Rename 


10=Define 
Opt Name Text 
*ORIGINAL Customer Copy 
FILE File Copy 
PACKING Packing List 


Bottom 


F3=Exit F5=Refresh  F12=Cancel 


Figure 85. Create with Copies panel 


9. The page format copy function has created the same three copies under the 
PAGEN page format. At this point, open these copies and make any changes 
to the page layout for the PAGEN pages. The principal difference between the 
copies is in the use of the different overlays. 


10. Press Enter until the Work with Print Definitions panel appears. 
11. Select option 10 Define a Print Definition panel appears. 
12. Select option 1 Define Selection Rules for Page Formats panel appears. 


a Define a Print Definition +) 
Print Definition ..: INVOICE 
Libranys cr ee ee cess QAPU 
Type options, press Enter. 
1=Select 


Opt Function 
Select a sample spooled file 
Set print definition attributes 
Define selection fields for page formats 
1 Define selection rules for page formats 


F3=Exit  F12=Cancel 


Figure 86. Define Selection Rules panel 


13. Using the Define a Rule panel, type the logic for identifying Page 1. If the 
value of PAGEN is 1, then APU will select page format PAGE1, as shown in 
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Type choices, press Enter. 


Define a Rule 


Ruitesnumber <3 <3? 10 

Condition: ds) a. ee IF IF, blank 

Pedidos: ieee te a wee cs PAGEN Name F4 for list 

MOS grees inte eect tse eons *EQ *EQ, *NE, *GT... 

Field or 'Characters' . bali Value F4 for list 

AC UIION: ail eoeses cates eames *USE *USE, *OMIT, *GOTO 

Page format or rule PAGE1 Value F4 for list 

Condit ttonre2. ess, vos AND, OR 

Filedidint ser cor cs, erase tec Name F4 for list 

WeSt: ane cen wen at *EQ, *NE, *GT... 

Field or 'Characters' Value F4 for list 

ACUIONS cei exces, =) sua? wae *USE, *OMIT, *GOTO 

Page format or rule. . Value F4 for list 
More... 

F4=Prompt F12=Cancel 

NS J 


Figure 87. Define a Rule panel 


Note: You do not have to type the logic for identifying pages greater than 


page one. 
14. If the value of PAGEN is not 1, then APU will select page format PAGEN, as 
shown in 
i 
Define a Rule . 
Type choices, press Enter. 
Rule number. .... 20 
Condition 2 so, usta IF, blank 
VOM Gh ye%) ee eviskoer ee ass 3 Name F4 for list 
Recline oer eet *EQ, *NE, *GT... 
Field or 'Characters' . Value F4 for list 
Action: 5%. 4 3 a & *USE *USE, *OMIT, *GOTO 
Page format or rule. . PAGEN Value F4 for list 
CONGTENON 20. a5 st m AND, OR 
UCU Cres coihedetet ee ast suesiue Name F4 for list 
NCSitwepesrrurers hroncaasest te *EQ, *NE, *GT... 
Field or 'Characters' . Value F4 for list 
AGtionia eaten *USE, *OMIT, *GOTO 
Page format or rule. . Value F4 for list 
More... 
F4=Prompt F12=Cancel 
Ke S 


Figure 88. Define a Rule panel 


15. After you have defined rules for PAGE1 and PAGEN, press Enter. The Define 
Selection Rules panel appears. On this panel, APU summarizes the current 
selection rules for the INVOICE print definition, as shown in 
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Va 


Define Selection Rules 


Print definition .. INVOICE 
IETIDRAWV ie. eas) cou cere QAPU 


Type options, press Enter. 
1=Create 2=Modify 4=Delete 


Opt Rule Cond Field Test Field or 'Characters' Act. 
10 =IF PAGEN *EQ) So el! *USE 
20 *USE 


ee F5=Refresh  F12=Cancel F22=Renumber 


Page format 
or Rule 


PAGE1 
PAGEN 


Bottom 


Figure 89. Define Selection Rules panel 


16. After you have completed the selection rules, press F3 to return to the Work 


with Print Definitions panel. 
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Part 3. Printing With APU 


Chapter 5. Manual and Command Line Printing 
with APU . : 
Methods of Printing with APU. 
Manually Associating a Print Definition witha a 
Spooled File . 

Panel 1: Apply Print Detain: 

Panel 2: Apply Print Definition . 

Panel 3: Apply Print Definition . 
Using the Apply Print Definition Command 


Chapter 6. Automatic Printing with APU Monitor 
Introduction to the APU Monitor . . 
Understanding How the APU Monitor Worke . 
An Example of APU Monitor Processing 
A Customer Environment. : 
Implementing the Customer Requirements c on ihe 
APU Monitor. 
Condition of the Output Oneue des Processing 
Configuring APU Monitor 
Specifying the Queues APU is fy Moniiar 
Configuring APU Monitor Action . 
Initial Panel 
Creating an Action Group Entry 
Defining Selection for Input Spooled File 
Defining Action for Input Spooled File 
Defining Action for Output Spooled File. 
An Example of this Processing Step 
Defining User Exit Before and Middle 
Defining User Exit After . x 
Starting APU Monitor . 
Stopping APU Monitor 
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Chapter 5. Manual and Command Line Printing with APU 


This chapter describes the methods of printing your print definition, and describes 
two of these three standard methods in detail: 


Methods of Printing with APU 


You can use any of three methods to print with APU: 


i|P Manually associating a print definition with a specific spooled file. For manual 
apply” your print definition to a specific spooled file. Refer 


2. Using. the Apply Print Definition command, which enables you to imbed an 


APU printing step within existing application eee Refer to 


3. Using the APU Monitor to automatically identify the sample spooled file and 
run the conversion programs. This method is described in Chapter 6] 


Manually Associating a Print Definition with a Spooled File 


This process works as follows. Using your print definition, SUNSD1 or INVOICE, 
select option 2 from the APU Main Menu. The Work with Spooled Files panel 


appears. 
ia > 
Select a Sample Spooled File 
Output Queue. .... QYPUOUTQ Name, *ALL F4 for list 
ISIDVARY oc. coeur oe. QAPU Name, *LIBL 
Were eal cares e rons *ALL Name, *CURRENT, *ALL 


Type choices, press Enter. 
l=Select 5=Display 


File Total 
Opt File Nbr User User Data Queue Sts Pages 
INVPRE 1 PERELMAN QYPUOUTQ RDY 7 
INVSCS 2 PERELMAN QYPUOUTQ HLD 6 
Bottom 
F4=Prompt F5=Refresh  F12=Cancel 
cE / 


Figure 90. Select Spooled File 


You can display selected output queues and spooled files with this option, and 
then apply a print definition to the spooled file for example, INVSCS. 
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( Apply Print Definition (APYPRTDEF) ) 

Type choices, press Enter. 
SES: SpooledRilie: < es8 ce are aes > INVSCS ame 
VODMMAMeCR Sartre. cemretecersuectet cule > QPADEV0O016 ame, * 

WS Cite mnare meet eC oe suet atolaemecmrr ans > JOHN ame 

Number. &. a Ge wie ee we > 098677 000000-999999 
SCS Spooled file number .... > 10 1-9999, *ONLY, *LAST 
Print Derinition 2 44 26 = «4 > INVOICE ame, *NONE, *SPOOLFILE 

Library (name; i. ss. 3x ce @ ce > — QAPU ame, *PRIDEFLIB, *LIBL 
RUMMOPEAONite co csu edness seats *NORMAL *NORMAL, *NOCOPY, *REPRINT 
Post processing SUCCESS: 

SCS: Spoolied Fille: 5. . 5. < 2 « > *NONE *HOLD, *NONE, *DELETE, *OUTQ 

Quéput queue i.e ee) ccesd a es ame 

Dray MaM@ns ss eo, eae ee ame, *LIBL 

Post processing FAILURE: 

SCS “Spoolied Files. ec 8 > *NONE *HOLD, *NONE, *DELETE, *OUTQ 

Output queues sce vs) re bs ame 

eiIbDranVomamer a. tere weiseee, feo ame, *LIBL 
More... 

F3=Exit F4=Prompt F5=Refresh  F12=Cancel F13=How to use this display 
F24=More keys 


Figure 91. Apply Print Definition panel 


APU will move the input spooled file to the output queue defined in the Success 
or Failure fields, depending on the result, and will place the file in one of the four 
status conditions shown above. *HOLD is the default for both success and failure. 


Some of the fields you should fill out include: 


Input Spooled File 
Name of the input spooled (SCS) file to which a print definition is to be 
applied. 

Print Definition 
Name of the print definition to be applied to the spooled file. 


Success or Failure 
Specify what you want to happen to the input spooled file on success or 
failure. 


Press the “Page Down” key to access the next panel. 
Note: INVSCS can also be used with the SUPER and SUPER? print definition 


samples that are in the QAPU library. INVPRE can be used with the 
AMASTER print definition, that is also in the QAPU library. 


Panel 2: Apply Print Definition 


Make the entries you want. Press F1 for descriptions of the fields. Here is a 
Gy ; re >) 

Apply Print Definition (APYPRTDEF) 
Type choices, press Enter. 
User exit BEFORE: 

PMOGAM ois. Ss Sie sacs “ete: cor Gee co *NONE ame, *NONE 

Library Name. = 6.0 aus. aus ame, *LIBL 

User parameter... ....4. 
User exit MIDDLE: 

PGOGRAMNpeitaesn secscreaie) cousseenba ns *NONE ame, *NONE 

Eabrany (Name: i A+ eas oe ee ame, *LIBL 

User parameter’... .: 4.6 «ia 
Device: Names te oseecai ey ce) tc eae *JOB ame, *JOB 
Qutput: queue: ss <3 we was ws *SPOOLFILE ame, *DEV, *SPOOLFILE 

LibraryiNamees soot. Gi Gece sv os ame, *LIBL 
Spooled file name ....... *SPOOLFILE ame, *SPOOLFILE, *PRTDEF 
Userdata. 3. 24 35% ee aes *SPOOLFILE Character value... 
ROW y,0 Crem etal stench etiam amet cs *SPOOLFILE Character value... 
Hold spooled file ....... *NO *NO, *YES 
Save spooled file ....... «NO *NO, *YES, *SPOOLFILE 

More... 
F3=Exit F4=Prompt F5=Refresh  F12=Cancel F13=How to use this display 
F24=More keys 
if J 


Figure 92. Apply Print Definition panel 


description of some of the key fields: 


User exit BEFORE 
Initializes the name of a program you want run before processing. Refer to 


User exit MIDDLE 
Name of a program you want to be run after the input spooled file has 
been copied to the input spool database. Refer to 


Device name 
Name of the printer on which the output is to be printed. 


Output Queue 
Name of the queue for the output file. 


Spooled file name 
Name to be given to the output. 


User data 
A user-defined parameter in the form of a character string to be placed on 
the output. 


Hold or Save 
Specify what you want done with the spooled file after it is processed. 
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Panel 3: Apply Print Definition 


Make the entries you want. Press F1 for descriptions of the fields. Key field entries 
i 
Apply Print Definition (APYPRTDEF) ) 
Type choices, press Enter. 
Qutpuebiiiinees <2 ors sneees see ten *SPOOLFILE 1-65536, *SPOOLFILE, *DEVD 
User exit AFTER: 
PROGICAN css ce ee ouerieiaa) oe res *NONE Name, *NONE 
Enbrany Name@rs: cs, -e e: se) Name, *LIBL 
User parameter <.. c: cose. cc er eo % 
Bottom 
F3=Exit F4=Prompt F5=Refresh  F12=Cancel F13=How to use this display 
F24=More keys 
oy 


Figure 93. Apply Print Definition panel 


here are: 


Output bin 
Where the output is to be placed. 


User exit AFTER 
Name of a program you want to be run after the AFPDS output spooled 
file has been created. Refer to . 


Using the Apply Print Definition Command 
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One method of starting APU is to use the Apply Print Definition (APYPRTDEF) 
command. This is the same command that is called when you manually apply a 
print definition to a spooled file, working from the “Work with Spooled Files” 


Note: Refer to 
using the APYPRTDEF command. 


for some helpful hints on 


To use the apply print definition command, place the command within existing 
application procedures, such as a CL (Control Language) program. An example of 
the command is shown below: 


APYPRTDEF FILE(INVSCS) JOB(098677/JOHN/QPADEV0016) SPLNBR(10)+ 
PRTDEF (QAPU/INVOICE) SUCCESS(*NONE) FAILURE(*NONE) DEV(PRT3130) 


This command selects the INVSCS spooled file from the currently running job 
(either batch or interactive) and starts APU printing, using the INVOICE print 
definition. The new AFP output is sent to the output queue that is associated with 
the PRT3130 printer device. 


Note: The APYPRTDEF command can also be used to run in batch. 
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To give you an understanding of the operation of the APU Monitor, the following 
topics are described here: 


Introduction to the APU Monitor 


The APU monitor is part of APU and provides a good way to integrate APU print 
definitions into your environment. The first version of the monitor was limited in 
its capabilities. With the modification level, new functionality has been added to 
the APU Monitor. 


The new monitor provides a major enhancement of APU with many new 
functions. It also removes some of the restrictions that were in the first version of 
the monitor, such as: 


* The spooled file name and the APU print definition name no longer need to be 
the same 


* In the earlier version of the APU Monitor, the SCS spooled file could only be set 
in the hold status 


* The earlier version of the APU Monitor placed spooled files into one unique 
output queue 


When using the new APU Monitor, you can: 
* Define which elements are relevant for selecting the spooled file 


* What is to be done with the original SCS spoolfile once APU Monitor processing 
is completed 


* Control how APU Monitor processes your print definitions 


Understanding How the APU Monitor Works 


In the new APU Monitor, you can specify values for the parameters that govern 
APU Monitor processing. These parameters are grouped together and called an 
“Action”. 


There are three “Action” groups in the new APU Monitor. The Monitor processes 
these actions in the following sequence: 


* Selection for input spooled file 
* Action for input spooled file 
* Action for output spooled file 


Note: If an action group contains more than one action, the actions are processed 
in the order in which they are defined. 
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Figure 94] diagrams the sequence in which the APU Monitor processes the action 
groups. 


selectionl} action action 
eT a [a [oe 
a al 
| ee 


Figure 94. APU Monitor Processing Sequence 


Here is an explanation of the steps shown in the diagram: 

1. The monitor is invoked each time a spooled file arrives in a monitored output 
queue or if the spooled file status from a spool in a monitored queue changes 
to *RDY. Spooled files with other status conditions are not processed. 

2. The monitor checks the input selection from each action rule in a sequential 
manner. 

3. As soon as a spooled file matches the action input selection, the input and 
output action are performed. Subsequent actions are ignored. 

4. The input action is applied after the selection matches a spooled file. The action 
performed depends on whether or not APU is able to complete the job 
successfully. 

5. You can define up to 16 output actions. This allows you, for example, to use 
several different APU print definitions for the same spooled file. 


6. One or more spooled files are placed into one or more output queues. 


An Example of APU Monitor Processing 


This section describes an example of how the concepts of the APU Monitor can be 
implemented in a customer environment. 


A Customer Environment 
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Assume that a customer wants to set up the following environment: 

* Three different output types are needed. with each going to a different output 
queue (OUTQs). 

* Two printers are available, and the monitor is to be set up with the following 
requirements: 


— System output (QSYSPRT) must not use an APU print definition. 
— All jobs in OUTQ1 must be sent to PRTO1 
- All jobs in OUTQ2 and OUTQ3 must be sent to PRTO2 


— Application jobs APPO1 and APP0O2 must be sent with a print definition 
SAMPLE applied 


— The application’s original spooled files must be placed in the OUTQ called 
SAVE. 


— The original QSYSPRT spooled files must be deleted. 


The Figure 95] diagrams these customer requirements. The numbers in the figure 
are used to identify the sequence of notes provided following this diagram. 


OUTQ1 OUTQ2 OUTQ2 SAVE 


PRT01 PRT02 


QSYSPRT (QSYSPRT)=A 
APPLICATION (APP01)=B 
APPLICATION (APP02)=C 


Figure 95. APU Monitor before Processing 


Notes 
1. All QSYSPRT spooled files from the OUTQ1 must be moved to OUTQ PRTO1. 


2. All QSYSPRT spooled files from all other OUTQs must be moved to OUTQ 
PRTO2. 


3. A print definition is to be applied to all application spooled files coming into 
OUTQI1. A new APU spooled file (the result of the APU processing) is to be 
placed in the output queue PRTO1. The original SCS spooled file is moved into 
OUTQ SAVE. 


4. A print definition is to be applied to all application spooled files coming into 
all other OUTQs. A new APU spooled file (the result of the APU processing) is 
to be placed in the output queue PRT02 for each original spooled file. The 
original SCS spooled file is to be moved into OUTQ SAVE. 


Implementing the Customer Requirements on the APU Monitor 


In the example, we can define two groups of spooled files: the application spooled 
files and the QSYSPRT spooled files. Only the application spooled files need an 
APU print definition. In this case, we want to define actions for the application 
spooled files first and then the action for the QSYSPRT spooled files. So we can say 
that all spooled files that are not eligible for APU are moved following the 
QSYSPRT spooled file actions. 


shows which parameters must be defined for each action in 
the order of the action. The monitor takes the Input selection parameters of the 
first action to identify if the spool and selection match. If the input selection 
parameters do not match the spooled file, the monitor takes the next action. As 
soon as the input selection parameters match the spooled file, all action sequences 
such as Input action and Output actions proceed. 
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The numbers in the figure indicate the actions that correspond with Figure 94 : 


; Input Input Output 
Action selection action action 
1. Action for File = APP* Success = *outq Prtdef = Sample 
spool OUTQ = Outq1 OUTQ = SAVE OUTQ = PRTO1 
Failure = *hold 


2. Action for File = APP* Success = *outq Prtdef = Sample 
spool OUTQ = “all OUTQ = SAVE OUTQ = PRT02 
Failure = *hold 
3. Action for File = *all Success = *outq Prtdef = *none 
spool OUTQ = Outq1 OUTQ = PRTO1 
Failure = *hold 
4. Action for File = “all Success = *outq Pridef = *none 
spool OUTQ = “all OUTQ = PRT02 
Failure = *hold 


Figure 96. APU Monitor - Action Example 


Notes 

1. Action for the application spooled files in OUTQ1 

2. Action for all other application spooled files in all monitored OUTQs 
3. Action for all other spooled files in OUTQ1 

4. Action for all other spooled files in all other OUTQs 


Many other options are possible for each action. You can decide, for example, to 
delete the original spooled files after processing or hold the spooled files. 


Condition of the Output Queue after Processing 
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In Figure 97) you can see the two QSYSPRT spooled files (A), that all the original 
application spooled files are in output queue SAVE, and that the new AFPDS 
spooled files (outcome from APU processing) are placed in the output queues 
PRTO1 and PRT02, depending on where the original was. 


2 PRTO2 


ie a 


QSYSPRT (QSYSPRT)=A 
APPLICATION (APP01)=B 
APPLICATION (APP02)=C 


Figure 97. APU Monitor Example After Processing 


Notes 
1. The QSYSPRT spooled file from OUTQ1 is in the output queue PRTO1. 


2. All QSYSPRT spooled files from the other OUTQs are in the output queue 
PTRO2. 

3. The original application SCS spooled files from OUTQ1 are in the output queue 
SAVE. New AFPDS spooled files have been placed in the output queue PRTO1. 
This new spooled file is the result from APU after applying the print definition. 

4. All other original application SCS spooled files from all other OUTQs are 
placed in the output queue SAVE. New AFPDS spooled files have been placed 
in the output queue PRT02. These new spooled files result from APU after 
applying the print definition. 


Note: If the processing for one spooled file fails, the original spooled file stays in 
the output queue in status *HOLD following the FAILURE parameter. 


Configuring APU Monitor 


Before using APU Monitor, you must configure it. This section describes the APU 
panels that you use to configure the APU Monitor. 


The following configuration steps are needed: 


1. Specif ibe queues that APU Monitor is to monitor. Refer to 


2. Configure the APU Monitor ee Refer to euring A Mon 


These steps are performed from the APU Main Menu, shown in Figure 98. 


ia ~ 
APU IBM Advanced Print Utility 


Select one of the following: 


Build and Test APU Print Definitions 
1. Work with Print Definitions 
2. Work with Spooled Files 


Run APU in Batch Mode 
3. Work with APU Monitor 
4. Start APU Monitor 
5. End APU Monitor 


Configure APU 
6. Set APU Defaults 
7. Work with Fonts 
8. Configure APU Monitor Action 


ection or command 


vo 


Figure 98. APU Main Menu 


The following sections show you how to perform these tasks. 
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Specifying the Queues APU is to Monitor 


The first task to perform is to specify the queues (OUTQs) the APU Monitor is to 
monitor. You can add or remove OUTQs from the list. You need to add only the 
queue where the spooled file action is performed on an APU print definition. If a 
spooled file comes from other OUTQs, no processing on them is done by the APU 
Monitor. To specify the queues to be monitored, take the following steps. 


1. Access option 3, Work with APU Monitor at the APU Main menu. 


2. The first panel that displays shows the set of currently monitored output 
queues: 


(a eS 
Work with APU Monitor 
APU Monitor status .: Active The output queues in the list are 


currently monitored by APU 


Type options, press Enter. 
1=Add  4=Remove 


Output 

Opt queue Library Text 

~~ QUTQI QGPL Input OUTQL 
OUTQ2 QGPL Input QUTQ2 
OUTQ3 QGPL Input OQUTQ3 


Bottom 


F3=Exit F5=Refresh  F12=Cancel 


Figure 99. Work with APU Monitor 


3. If the output queue is all right, exit the function and go to LConfiguring API] 


ge 89 If you want to specify additional queues, enter a 1 
in the top, leftmost row to add a new queue: 


\‘ ; : Sh 
Work with APU Monitor 


APU Monitor status .: Inactive The output queues in the list will be 
monitored by APU, when the monitor is 
started. 

Type options, press Enter. 

1=Add  4=Remove 
Output 
Opt queue Library Text 
1 
Add an Output Queue to the APU Monitor 

Type choices, press Enter. 

Qutput queue ..... Name F4 for list 

Dilbraryers vests nas *LIBL, Name 
F4=Prompt F12=Cancel 
Bottom 


Figure 100. Add a New Output Queue 


4. Enter the new output queue name, then enter the name of the library where the 
queue is stored. 
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Configuring APU Monitor Action 
To set up APU Monitor actions, you need to access item 8 on the APU Main menu, 
Configure APU Monitor Action. This selection displays an initial panel, followed 
by several additional panels. 


This section describes each part of a Monitor action. Each action has the following 
three parts: 

* Selection for input spooled file 

* Action for input spooled file 

* Action for output spooled file 


The Configure APU Monitor Action display allows you to create, change, copy, 
and delete actions. Each action is performed in the sequence shown on the display 
by the APU print engine. 


Initial Panel 

The Configure APU Monitor Action panel allows you to develop a table with 
selections and actions that the APU monitor and print engine have to perform. 

The initial panel allows a user to create, change, copy or delete action entries. The 
e >) 


Configure APU Monitor Action 


Type options, press Enter. 
1=Create 2=Change 3=Copy 4=Delete 


Opt Sequence Text 


1 
20 Qsysprt spool in all other OUTQ's 
30 QPJOB spool in OUTQ1 
40 QPJOB spool in all other OUTQ's 
50 All other spool in OUTQ1 
60 All other spool in all other OUTQ's 


F3=Exit F5=Refresh  F12=Cancel F22=Renumber Sequence 


Figure 101. Configure APU Monitor Action panel 


F22 key is used to renumber the entries automatically. The renumbering uses an 
increment of 10 unless the number of records is greater than 999. In that case the 
increment will be calculated depending on the number of records. 


At runtime the monitor will retrieve the SCS spooled file attributes and try to find 
a matching entry. The monitor evaluates the entries in the order of the user-entered 
sequence numbers. As soon as the monitor finds a match, it processes the spooled 
file according to the rest of the information in the table. If is does not find a match 
in the table, a message is put into the monitor’s joblog and the spooled file is not 
processed. 


Creating an Action Group Entry 
To create an action group entry, proceed as follows. 


‘A: aon 1 under the OPT column to create a new sequence number, as shown in 
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(e > 


Create Action Entry 
Type choices, press Enter. 


Sequence: 2 <. % 3 ee 10 Number 
MONG eterna eee nares QSYSPRT spool in OUTQ1 


Type options, press Enter. 
1=Select 


Opt Function 
1 Define selection for input spooled file 


1 Define action for input spooled file 
1 Define action for output spooled file 


F12=Cancel 


Figure 102. Configure APU Monitor Action panel 


2. Type in a sequence number. APU Monitor uses this number to determine when 
to perform the test that is specified by the rule. If you want this test performed 
first, enter a number that is less than any previous rule number. 


3. Type in a description of the rule. 


Note: Note that a rule may apply to all three types of action groups. 


4. Within an action entry a user can set up three separate or combined actions. 
Select the action to which the rule is to apply, by typing a 1 next to the item. 
Depending on what you selected, you will need to type in or select values for 
one or more panels. Go to the appropriate section for the action you selected: 


Defining Selection for Input Spooled File 

You use the first panel to define selection criteria for the input spooled file. In 
other words, you use this panel to select the SCS spooled file that will be 
processed as input. From this panel the user can decide what spooled file 
attributes the monitor should use to match an SCS spooled file with. 


When the APU Monitor is running, it looks for a file or files with the attributes 
that are provided on this display. If APU finds a match between the attributes you 
enter here and an input spooled file, it processes both entries, Action for Input 
and Action for Output Spooled. 


If you select Define selection for input spooled file, the following panel displays: 


‘a . 


Define Selection for Input Spooled File 


Sequence ......: 10 
TEMG ee ena ea ee are? QSYSPRT spool in OUTQ1 


Type choices, press Enter. 


Fillies eh wiees tee teyee csi QPJOB* Name, Generic*, *ALL 
Output queue ..... OUTQ1 Name, Generic*, *ALL 

IID AIRY 2% oeeen ee er tere *LIBL Name, *LIBL 
US rae tec catvapere snes *ALL User, Generic*, *ALL 
User’Dataics 2.0 Se *ALL User Data, Generic*, *ALL 
FOCMMIY Pee “5 she) cet *ALL Form Type, Generic*, *ALL 
PINOGR aN eda, sgt tss bane *ALL Name, Generic*, *ALL 

ISTID ayers, sen serve Ree eh ae Name, *LIBL 


Figure 103. Define Selection for Input Spooled File panel 
You enter values that APU uses to select the input spooled file. Following is a 
description of the values you can enter: 


Spooled file name 
This can be a specific name, a generic name, or *ALL. 


Output queue/Library 
This can be a specific output queue, a generic name, or *ALL. 


User This can be a specific user, a generic set, or *ALL. 


User Data 
This can be a specific entry in the user data field, generic data, or *ALL. 


Form Type 
This can be a specific form, a generic form, or *ALL. 


Program name/Library 
This can be a specific program, a generic program, or *ALL. 


When you run the APU Monitor, it looks for a file or files with the attributes that 
are provided on this panel. Note that all the attributes that are specified here are 
ANDed, so the effect of a set of attributes is to narrow a search. 


If APU finds a match between the attributes you enter here and an input spooled 
file, it processes the next file it finds in one of the monitored queues, and the 


If APU does not find a match between the selection criteria on the panel and the 
next spooled file, no action is taken. 


Defining Action for Input Spooled File 

With the Define Action for Output Spooled File, the detailed production 
processing of the input spooled file is configured. You can define up to 16 
processing phases (called action groups). Within each of these action groups, the 
following processing can occur: 


* Call the “before” user program 
* Copy the input spooled file to a working database file 
* Call the “middle” user program 
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* Transform the input database file to an AFP database file, using specified APU 
print definition 

* Write the output AFP database file to the specified output queue 

* Call the “after” user program 


The Define Action for Output Spooled File display, consisting of two displays for 
each action group, provide for configuring the processing options. These options 
include the APU print definition, the user exit programs, the run option, and the 
output file options. Using multiple action groups, you can apply multiple APU 
print definitions to the same input spooled file, invoke user programs for unique 
processing, and define multiple, different output actions. 


If you select Define action for input spooled file, the following panel displays: 


i > 
Define Action for Input Spooled File 

Sequence: . 2 <5 «2 10 

TONE orc eae teeta eas cs QSYSPRT spool in OUTQ1 


Type choices for input spooled file after successful 
or failed processing respectively, press Enter. 


SUCCESS trun whee cleo pentenaes *OUTQ *NONE, *HOLD, *DELETE, *OUTQ 
Output queue .... OUT1 Name 
[AIDA eects aes *LIBL Name, *LIBL 
FaidlUne are esya Amen ueor casters *HOLD *NONE, *HOLD, *DELETE, *OUTQ 
Output queue .... Name 
IDNA? Aen oy ees Name, *LIBL 
Ke ey 


Figure 104. Define Action for Input Spooled File panel 


APU will move the input spooled file to the output queue defined in the Success 
or Failure fields, depending on the result, and will place the file in one of the four 
status conditions shown above. *HOLD is the default for both failure and success. 


Defining Action for Output Spooled File 

The third thing a user can do in configuring APU monitor action is to define action 
for output spooled file. This is probably the most complicated portion. The user 
can enter information on two panels (which make up an action group) by 
describing tasks the print engine performs. The user can scroll through (or set up) 
a total of 16 separate actions groups to be performed. This makes it possible to 
process several print definitions against one SCS spooled file. 


Before describing in detail the various parameters that could be set for this step, an 
extended example may help to clarify the concepts. 


An Example of this Processing Step 

Imagine that you print at two different locations. You want to identify which 
invoice is for the local system and which one is for the second location. This is 
possible with the conditional option in the print definition. You must define two 
different print definitions. Each uses conditional processing to select which invoice 
will be in the new spooled file. (Each print definition produces one spooled file.) 


For the monitor, the user must define two actions for output spooled files. Each 
action refers to one of the print definitions. At run time, the print engine runs both 
print definitions with a different Output Queue for each. 


Figure 105. Action Example for Two Locations 


Notes 


. Input Input Output Output 
Action selection action action 1/2 action 2/2 
1. Action for File = APP* Success = *outq | Prtdef = Sample | Prtdef=Sample2 
spool OUTQ = Outq1 OUTQ =SAVE OUTQ= PRT01 | OUTQ=Paris 
Failure = *hold 
2. Action for File = APP* Success = “outq | Pridef = Sample | Prtdef= Sample2 
spool OUTQ = “all OUTQ =SAVE | OUTQ=PRTO2 | OUTQ= Paris 
Failure = *hold 
3. Action for File = “all Success = *outq | Pridef = *none 
spool OUTQ = Outq1 OUTQ =PRT01 
Failure = *hold 
4. Action for File = “all Success = *outq | Pridef = *none 
spool OUTQ = “all OUTQ =PRT02 
v Failure = “hold 


1. Action for the application spooled files in OUTQ1. An additional output action 
sequence is added. 


2. Asecond print definition is applied with a different output queue. 


wo 


Action for all other application spooled files in all monitored OUTQs. 


4. An additional output section sequence is added. A second print definition is 
applied with a different output queue. 


5. Action for all other spooled files in OUTQ1. 
6. Action for all other spooled files in all other OUTQs. 


7. If an empty or not correct output action is provided, the action for the Input 
SCS spooled file follows the failed procedure. 


The next figure shows how the actions are executed from the monitor. Due to the 
conditional processing of the print definition, the application spooled file has been 
split into a local and remote output queue (designated as “Paris” in 

Page od). The white spooled file represents that only the location dependent data is 


present. 
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MB patot Bf BpParis Bi BBPRTO2 


OUTQI1 OUTQ2 OUTQ3 SAVE 


F eG io 


wt pda cae 


QSYSPRT (QSYSPRT) =A 
APPLICATION (APP01) = B 
APPLICATION (APP02) = C 


Figure 106. Spooled File Location after Processing 


Notes 


1. 
a 
3. 


The QSYSPRT spooled files from OUTQI1 are in PRTO1 OUTQ. 

All QSYSPRT spooled files from the other OUTQs are in PRT02 OUTQ. 

All original application spooled files from OUT1 are placed in OUTQ SAVE 
after processing. A new AFPS spooled file has been placed in PRTO1 for each 
spooled file formatted with the print definition “SAMPLE”. 

A second AFPDS spooled file formatted with the print definition “SAMPLE2” 
has been placed in the output queue “PARIS” for each spooled file. 

All other original application spooled files from all other OUTQs are placed in 
OUTQ SAVE after processing. A new AFPS spooled file has been placed in 
PRT02 for each spooled file formatted with the print definition “SAMPLE”. 


A second AFPDS spooled file formatted with the print definition “SAMPLE2” 
has been placed in the output queue “PARIS” for each spooled file. 


Defining User Exit Before and Middle 


If you select Define action for output spooled file, the following panel displays: 


ie ~ 


Define Action for Output Spooled File 


Sequence ......: 10 

TMC ees eee an eee are QSYSPRT spool in OUTQ1 
ACELONG aiccnsceeen ie rees Taal 

Pane lice sseuece se xteetes ce La: 62 


Type choices, press Enter. 


User exit before ... *NONE Name, *NONE 
LET RAN ects: arenes ones Name, *LIBL 
User parameter ... Value 
Print Definition ... SAMPLE Name, *SPOOLFILE, *NONE 
DAR Vai eae asreor ese es *PRTDEFLIB Name, *PRTDEFLIB, *LIBL 
Run'optiion 6 3 ¢ *NORMAL *NORMAL, *NOCOPY, *REPRINT 
User exit middle ... *NONE Name, *NONE 
[ETD RAN Yee Seayssrsn essa Name, *LIBL 
User parameter ... Value 
Output device. .... *JOB Name, *JOB 
Output queue ..... PRTO1 Name, *DEV, *SPOOLFILE 
ITB MaNyerss ese yoneee esse *LIBL Name, *LIBL 
====> 
F12=Cancel F15=Next action 


Figure 107. Define Action for Output Spooled File panel 


On this panel, you specify the name, library, and user-defined parameter for the 
program that APU is to call before, during, or after processing. The default is 
*NONE. Refer to [Appendix B 03) for details about the user 
exits. 


The Print Definition lines contain values for the library where the print definition 
is stored, and for the “Run Option.” 


Following are the values that could be entered for Run Option: 


Ignored 
If you specify *NONE on the print definition field, any value you place 
here is ignored. 


*NORMAL 
This is the default entry. If only one action (of 16) is defined, “NORMAL is 
the only valid value for the field, so the value must be *NORMAL for the 
first (or only) action. 


*NOCOPY 
This value is valid only if specified for the second (or later) action group. It 
allows different print definitions for the same spooled file. 


*REPRINT 
This value is valid only if specified for the second (or later) action. This 
value is used if you want to apply the same print definition multiple times 
on the same spooled file. 


In the output device field, you specify the name of the device on which the 
spooled file is to be printed. The value *JOB gets APU to place the output spooled 


file in the out-queue of the current device. 


The output queue field contains the name of the output queue where the spooled 
file is to be placed. *SPOOLFILE tells APU to place the output file in the same 
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output queue where the input spooled file was found. *DEV has APU place the file 
into the output queue of the device specified in the Output Device field. 


Defining User Exit After 


This panel is used to specify what is to be done after processing a file. 


(G =“ 
Define Action for Output Spooled File 
Sequence « 2) isc 232) 10 
TEX oes % ewe et QSYSPRT spool in OUTQ1 
AGELONG seacutes cess: se fame 
Panel 4. a8 acs ee 2 Af? 


Type choices, press Enter. 


RU cetera ee eee ake *SPOOLFILE Name, *PRTIDEF, *SPOOLFILE 
Wserm Data cits toe Gt *SPOOLFILE User Data, *PRIDEF, *SPOOLFILE 
Forty TYP@r. so ie os. ae *SPOOLFILE Form Type, *PRIDEF, *SPOOLFILE 
[plot lta leacerstase eeuereen ramets oe «NO *YES, *NO 
Sa Vegan ntcuacec cunt acers ee «NO *YES, *NO, SPOOLFILE 
OUEPUE DIN: 22 Son a 6 *DEVD 1-65536, *DEVD, *SPOOLFILE 
User exit after... 4. *NONE Name, *NONE 

iD an yaccaee ca peancerce ss Name, *LIBL 

User parameter ... Value 

Bottom 
F12=Cancel F15=Next action 


Figure 108. Define Action for Output Spooled File panel 


File The File field is the name of the output spooled file. Use *PRTDEF if you 
want the output spooled file to have the same name as the print definition. 
Use *SPOOLFILE if you want the output spooled file to have the same 
name as the input spooled file. 


User Data 
The User Data field specifies the character string that is attached to the 
output file. *PRTDEF tells APU to set the value of this field to the name of 
the processed print definition. *SPOOLFILE tells APU to set this character 
string value to the data string of the input spooled file. 


Form Type 
The Form Type field names the form type of the output spooled file. 
*PRTDEF tells APU to set the form type to the name of the processed print 
definition. *SPOOLFILE sets the form type of the output file to the form of 
the input file. 


Hold The Hold field holds a value specifying the status that the output spooled 
file is top have. *NO sets the value to READY; *YES sets the value to 
HELD. 


Save The Save field specifies what happens to the output spooled file: *NO does 
not save the file; *YES saves the file. *SPOOLFILE does to the output 
spooled file what was done to the input spooled file. 


Output Bin 
The Output Bin field is the name of the output bin of the printer. *DEVD 
puts the file in the bin that is specified by the printer device description. 
*SPOOLFILE is used to specifiy the output bin of the input spooled file. 


User exit after 
The User exit after field contains the name, library, and user defined 
parameter for the program to be called by APU after the output spooled 
file has been created. 


Starting APU Monitor 
Begin at the APU Main menu, as shown in igure 104: 


(spy IBM Advanced Print Utility 
Select one of the following: 
Build and Test APU Print Definitions 
1. Work with Print Definitions 
2. Work with Spooled Files 
Run APU in Batch Mode 
3. Work with APU Monitor 
4. Start APU Monitor 
5. End APU Monitor 
Configure APU 
6. Set APU Defaults 
7. Work with Fonts 
8. Configure APU Monitor Action 
Selection or command 
===> 
F3=Exit F4=Prompt F9=Retrieve F12=Cancel F16=System main menu 
F23=Set initial menu 
5798-AF4 (C) COPYRIGHT IBM CORP. 1996, 1997 


Figure 109. APU Main Menu panel 


Select 4. Start APU Monitor to display the panel shown in Figure 110: 


A 
APU 
APU IBM Advanced Print Utility 


Select one of the following: 


Build and Test APU Print Definitions 


Start APU Monitor 


Numberof, active monitor JObS) 3 sc. 3. Se gs sew eee es veh el ws 0 
Number of monitor jobs in job queue(s) ...........4.: 0 


Type choices, press Enter. 


Job description. ...... QYPUJOBD Name 
ib rarvircawrcaececg tenner wee *LIBL Name, *LIBL, *CURLIB 


it F4=Prompt F9=Retrieve F12=Cancel Fl6=System main menu 
et initial menu 
Y 


nx 


Figure 110. Start APU Monitor panel 


Type in the job description and the library where it is stored, then press Enter to 
start the monitor. On pressing Enter, you return to the Main menu, and a message 
appears on the bottom of the panel telling that APU Monitor is started. 
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Stopping APU Monitor 


To stop the APU Monitor, return to the APU main menu and select 5. End APU 
Monitor: 


A 
APU IBM Advanced Print Utility 


Select one of the following: 
Build and Test APU Print Definitions 
1. Work with Print Definitions 
2. Work with Spooled Files 
Run APU in Batch Mode 
3. Work with APU Monitor 
4. Start APU Monitor 
5. End APU Monitor 
Configure APU 
6. Set APU Defaults 
7. Work with Fonts 
8. Configure APU Monitor Action 
Selection or command 
===> 
F3=Exit F4=Prompt F9=Retrieve F12=Cancel Fl6=System main menu 
F23=Set initial menu 
1 jobs ended, 1 jobs canceled 


Figure 111. Stop APU Monitor panel 
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Appendix A. APU Samples 


To help you become familiar with APU, the following sample materials have been 
provided in the QAPU library: 


Table 2. Samples in the QAPU Library 


Name Type 

AMASTER Print definition example to be used with INVPRE. 

GRID Overlay 

GRID1 Overlay 

INVALL Overlay 

INVBAC Overlay 

INVFST Overlay 

INVHEAD Overlay 

INVHEAD2 Overlay 

INVLST Overlay 

INVMID Overlay 

INVPRE Sample spooled file (in QYPUOUTQ) 

INVSCS Sample spooled file (in QYPUOUTQ) 

QCLSRC Contains a sample user exit 

QDDSRC DDS for use with the RPG sample program (INVSCS) 

QOVLSRC Overlay Source 

QRPGSRC Contains an RPG sample program to build INVSCS in the user’s 
OUTQ. Refer to 2 2 e e 

QYPUOUTQ Output Queue 

SAM3006 Overlay 

SEEDCUST Seed company customer master PF 

SEEDDETL Super Sun Seeds invoicing LF 

SEEDDETP Super Sun Seeds invoicing PF 

SEEDITEM Seed company item master PF 

STRWNB Page segment 

SUNLOGO Page segment 

SUPER Print definition example to be used with INVSCS 

SUPER2 Print definition example to be used with INVSCS 

TREENB Page segment 
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Appendix B. User Exits 


This appendix describes the user exits that are referred to in 


Processing Phases 


Following is a description of the processing phases the APU print engine goes 
through in general and when processing the user exits: 


Table 3. APU Print Engine Processing Phases 


Modified Version Pre-Modification 

Step Description Program Name Equivalent 

1 Call the user exit program EXTBEF None 
“before” 

2 Set up the internal environment | INZENV INZENV 
using the print definition. 

3 Create the internal spool CPYSPLF CPYSPLF 
database using the CPYSPLF 
command. 

4 Call the “middle” user exit. EXTMID None 
Process the input file and create |GENAFP GEN AFP 
an AFPDS output database. 

6 Convert the database to the PRIAFPDTA PRIAFPDTA 
spooled file using the 
PRTAFPDTA command. 

Z Call the “after” user exit EXTAFT None 
program. 

8 Perform post-processing action | INPACT None 
on the SCS spooled file. 


User Exit Before 


The USER EXIT BEFORE program includes the library the program is in and a 20 


character user parameter to be passed to the exit program. This program (phase 


EXTBEF) will be executed before the print engine starts to initialize (phase 
INZENV, which sets up the internal environment such as variables, tables, and so 
on) using the print definition. 


Following is the parameter structure passed by the APU print engine if a user exit 
is called for BEFORE processing is initialized: 
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Table 4. Parameters Passed to the Before Initialization User Exit 


INFILE Name of the Input spooled file 
INNBR File number of the input spooled file 
INTYPE Input type of spooled file (*SCS, *IPDS, *AFPDS, etc.) 
JOBUSR Input creating job&csq;s user 
JOBNAM Input creating job&csq;s name 
JOBNBR Input creating job&csq;s number 
INOQNM Input-output queue name 

INOQLB Input-output queue library 

INUSDT Input user data string 

INFORM Input form type 

INOBIN Input outbin 

INPGNM Input creating program name 
INPGLB Input creating program library 
PRTDEF Empty 

PRTDLB Empty 

SUCFLG Empty 

OTFILE Empty 

OTOQNM Empty 

OTOQLB Empty 

OTHOLD Empty 

OTSAVE Empty 

OTUSDT Empty 

OTFORM Empty 

OTOBIN Empty 

USRPRM Value from the User Parameter (before) field 


User Exit Middle 


A USER EXIT MIDDLE program includes the library the program is in and a 20 
character user parameter to be passed to the exit program. This program (phase 
EXTMID) will be run after the print engine copies the input spooled file to the 
input spool database. (This occurs in the CPYSPL phase, which creates the internal 
spool database using the CPYSPLF command.) 


Following is the parameter structure passed by the APU print engine if a user exit 
is called after the input spooled file has been copied to the input spool database: 
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Table 5. Parameters Passed to the Middle User Exit 


INFILE Name of the Input spooled file 

INNBR File number of the input spooled file 

INTYPE Input type of spooled file (*SCS, *IPDS, *AFPDS, etc.) 
JOBUSR Input creating job&csq;s user 

JOBNAM Input creating job&csq;s name 

JOBNBR Input creating job&csq;s number 

INOQNM Input-output queue name 

INOQLB Input-output queue library 

INUSDT Input user data string 

INFORM Input form type 

INOBIN Input outbin 

INPGNM Input creating program name 

INPGLB Input creating program library 

PRTIDEF Name of the print definition that will be applied 
PRTDLB Library of the print definition that will be applied 
SUCFLG Empty 

OTFILE Empty 

OTOQNM Empty 

OTOQLB Empty 

OTHOLD Empty 

OTSAVE Empty 

OTUSDT Empty 

OTFORM Empty 

OTOBIN Empty 

USRPRM Value from the User Parameter (before) field 


User Exit After 


A USER EXIT AFTER program includes the library the program is in and a 20 
character user parameter to be passed to the exit program. This program (that is 
run for the EXTAFT phase) will be run after the print engine creates the AFPDS 
output spooled file, which is done during the PRTAFP phase that converts the 
database to spooled file using the PRTAFPDTA command. 


Following is the parameter structure passed by the APU print engine if a user exit 
is called after the AFPDS output spooled file has been created: 
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Table 6. Parameters Passed to the User Exit After the AFPDS Spooled File has been 


Created 

INFILE Name of the Input spooled file 

INNBR File number of the input spooled file 

INTYPE Input type of spooled file (*SCS, *IPDS, *AFPDS, etc.) 

JOBUSR Input creating job&csq;s user 

JOBNAM Input creating job&csq;s name 

JOBNBR Input creating job&csq;s number 

INOQNM Input-output queue name 

INOQLB Input-output queue library 

INUSDT Input user data string 

INFORM Input form type 

INOBIN Input outbin 

INPGNM Input creating program name 

INPGLB Input creating program library 

PRTDEF Name of the print definition that will be applied 

PRTDLB Library of the print definition that will be applied 

SUCFLG *YES or *NO depending on success or failure 

OTFILE Name of the AFPDS output spooled file created 

OTOQNM Out-queue name of the created AFPDS output spooled file 

OTOQLB Library name of the created AFPDS output spooled file 

OTHOLD *YES or *NO depending on the Hold flag of the created AFPDS 
output spooled file 

OTSAVE *YES or *NO depending on the Save flag of the created AFPDS 
output spooled file 

OTUSDT User data string of the created AFPDS output spooled file 

OTFORM Form type of the created AFPDS output spooled file 

OTOBIN Outbin of the created AFPDS output spooled file 

USRPRM Value from the User Parameter (after) field 


Sample User Exit Program 


The following Control Language (CL) program provides a framework for using the 
before. middle, and after user exits within APU production processing. This 
program is provided in the QCCSRC file in the QAPU library. 


[RRR KKK KK ERK RRA K KKK KKK KKK KKK KK KEIRA KK IKKE AK KKK KKK KKK KKK KAKA AKER KEKE | 


/* NAME: QYPUEXTSMP x/ 
/* */ 
/* DESCRIPTIVE NAME: APU SAMPLE EXIT PROGRAM FOR APYPRTDEF */ 
/* 5798-AF4 (C) COPYRIGHT IBM CORP. 1997 */ 
/* */ 
/* FUNCTION: This sample program demonstrates the x/ 
/* new exit points in the APYPRTDEF command. */ 
/* */ 
[KEK RK KERR KK EAR KEK KKK KKK IKKE KK KKK KKK KK KKK KA KKK KKK KK KIRKE KAKA AKER KK | 
PGM PARM(&EXPARM) 
/* Exit program parameter string x/ 
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DCL 


DCL 


DCL 


DCL 


DCL 


DCL 


DCL 


DCL 


DCL 


DCL 


DCL 


DCL 


DCL 


DCL 


DCL 


DCL 


DCL 


DCL 


DCL 


DCL 


DCL 


DCL 


DCL 


VAR(&EXPARM)  TYPE(*CHAR) LEN(512) 


/* Type of exit point (*BEFORE,*MIDDLE, AFTER) 


VAR (&EXTYPE) TYPE(*CHAR) LEN(10) 


/* Name of input spooled file 
VAR(&EXINFILE) TYPE(*CHAR) LEN(10) 


/* Name of input spooled file number 
VAR(&EXINNBR) TYPE(*CHAR) LEN(10) 


/* Input Printer device type 
VAR(&EXINTYPE) TYPE(*CHAR) LEN(10) 


/* Input Jobs User 
VAR(&EXJOBUSR) TYPE(*CHAR) LEN(10) 


/* Input Jobs Name 
VAR(&EXJOBNAM) TYPE(*CHAR) LEN(10) 


/* Input Jobs Number (alpha) 
VAR(&EXJOBNBR) TYPE(*CHAR) LEN(06) 


/* Input Outq Name 
VAR(&EXINOQNM) TYPE(*CHAR) LEN(10) 


/* Input Outq Library 
VAR(&EXINOQLB) TYPE(*CHAR) LEN(10) 


/* Input User data 
VAR(&EXINUSDT) TYPE(*CHAR) LEN(10) 


/* Input Form type 
VAR(&EXINFORM) TYPE(*CHAR) LEN(10) 


/* Input out-bin 
VAR(&EXINOBIN) TYPE(*CHAR) LEN(10) 


/* Input Program Name 
VAR(&EXINPGNM) TYPE(*CHAR) LEN(10) 


/* Input Program Library 
VAR(&EXINPGLB) TYPE(*CHAR) LEN(10) 


/* Print Definition Name 
VAR(&EXPRTDEF) TYPE(*CHAR) LEN(10) 


/* Print Definition Library 
VAR(&EXPRTDLB) TYPE(*CHAR) LEN(10) 


/* Success flag (*YES, *NO, *ACTIVE) 
VAR(&EXSUCFLG) TYPE(*CHAR) LEN(10) 


/* Name of output spooled file 
VAR(&EXOTFILE) TYPE(*CHAR) LEN(10) 


/* Output Outq Name 
VAR(&EXOTOQNM) TYPE(*CHAR) LEN(10) 


/* Output Outgq Library 
VAR(&EXOTOQLB) TYPE(*CHAR) LEN(10) 


/* Output Hold Flag (*YES, *NO) 
VAR(&EXOTHOLD) TYPE(*CHAR) LEN(10) 


/* Output Save Flag (*YES, *NO) 
VAR(&EXOTSAVE) TYPE(*CHAR) LEN(10) 
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/* Output User data */ 


DCL VAR(&EXOTUSDT) TYPE(*CHAR) LEN(10) 
/* Output Form type */ 

DCL VAR(&EXOTFORM) TYPE(*CHAR) LEN(10) 
/* Output out-bin x/ 

DCL VAR(&EXOTOBIN) TYPE(*CHAR) LEN(10) 
/* User specified parameter for exit pgm */ 

DCL VAR(&EXUSRPRM) TYPE(*CHAR) LEN(20) 
/* Reserved for future use */ 

DCL VAR(&RESERVED) TYPE(*CHAR) LEN(246) 
[RRR R KKK KK ERIK KEK KR AKKK I KKEKKKEKK KK EK KKK AK KIA KK EAB KAKA EAA KEK IKEA AKER KEKE | 
/* */ 
/* STEP 1: Split parameter structure into single fields x/ 
a «/ 
/* */ 


[RRR R KKK K KEIR KEK KKK AKER KERR KEK KKK KKK IKKE AK KEK KKK IKEA KIKI AKER A AKER KE | 


STEP1: 
CHGVAR VAR (&EXTYPE) VALUE 
CHGVAR VAR(&EXINFILE) VALUE 
CHGVAR VAR(&EXINNBR) = VALUE 
CHGVAR VAR(&EXINTYPE) VALUE 
CHGVAR VAR(&EXJOBUSR) VALUE 
CHGVAR VAR(&EXJOBNAM) VALUE 
CHGVAR VAR(&EXJOBNBR) VALUE 
CHGVAR VAR(&EXINOQNM) VALUE 
CHGVAR VAR(&EXINOQLB) VALUE 
CHGVAR VAR(&EXINUSDT) VALUE 
CHGVAR VAR(&EXINFORM) VALUE 
CHGVAR VAR(&EXINOBIN) VALUE 
CHGVAR VAR(&EXINPGNM) VALUE 


(%SST(&EXPARM 001 010)) 
( 
( 
( 
( 
( 
( 
( 
( 
( 
( 
} 
CHGVAR VAR(&EXINPGLB) VALUE( 
( 
( 
( 
( 
( 
( 
( 
( 
( 
( 
( 
( 
( 


S 

SST(&EXPARM 011 010)) 
SST(&EXPARM 021 010)) 
SST(&EXPARM 031 010)) 
SST(&EXPARM 041 010) 
SST(&EXPARM 051 010 
SST(&EXPARM 061 006 
SST(&EXPARM 067 010 
SST(&EXPARM 077 010 
SST(&EXPARM 087 010 
SST(&EXPARM 097 010 
SST(&EXPARM 107 010 
SST(&EXPARM 117 010 
SST(&EXPARM 127 010 
S 
S 
S 
S 
S 
S 
S 
S 
S 
S 
S 
S 
S 


SS mS HS Ow 


CHGVAR VAR(&EXPRTDEF) VALUE 
CHGVAR VAR(&EXPRTDLB) VALUE 
CHGVAR VAR(&EXSUCFLG) VALUE 
CHGVAR VAR(&EXOTFILE) VALUE 
CHGVAR VAR(&EXOTOQNM) VALUE 
CHGVAR VAR(&EXOTOQLB) VALUE 
CHGVAR VAR(&EXOTHOLD) VALUE 
CHGVAR VAR(&EXOTSAVE) VALUE 
CHGVAR VAR(&EXOTUSDT) VALUE 
CHGVAR VAR(&EXOTFORM) VALUE 
CHGVAR VAR(&EXOTOBIN) VALUE 
CHGVAR VAR(&EXUSRPRM) VALUE 
CHGVAR VAR(&RESERVED) VALUE 


) 
) 
) 
) 
) 
) 
) 
) 
) 
ST(&EXPARM 137 010) 
ST(&EXPARM 147 010) 
ST(&EXPARM 157 010) 
ST(&EXPARM 167 010) 
ST(&EXPARM 177 010) 
ST(&EXPARM 187 010) 
ST(&EXPARM 197 010) 
ST(&EXPARM 207 010) 
ST(&EXPARM 217 010) 
ST(&EXPARM 227 010) 
ST(&EXPARM 237 010) 
ST(&EXPARM 247 020) 
ST(&EXPARM 267 246) 


de de de do dE BO DE BE DE BS DE BO DO BO BE BE DE BE DE DE DE BO AO BO BO BE BO 


[RRR R KKK KK EAR KEK KK AKKEIKKEKAKERA KK A KKK AK KK A KEI KKEK KKK IKKE KK KEK IKEA AKER KEKE | 


/* */ 
/* STEP 2: Analyze type of calling exit point in APYPRTDEF x/ 
——— «/ 
/* */ 


[EKA KKK KK EAR KERR KERRIER KKK EAKKKAKKIAKKE AK KEK AKAIKE IKKE KAKA AKER KE | 


STEP2: 
IF COND(&EXTYPE = *BEFORE) THEN(GOTO + 
CMDLBL(STEP3_BEF)) 


IF COND(&EXTYPE = *MIDDLE) THEN(GOTO + 
CMDLBL(STEP3_MID)) 


IF COND(&EXTYPE = *AFTER) THEN(GOTO + 
CMDLBL(STEP3_AFT)) 


GOTO CMDLBL(STEP4) 


[KEK RK ERA KER AK KEI KKK IKKE KK KEK KKK AKER IKEA KK IKKE IKKE IKKE AAR K IKEA AKER KKK | 


/* */ 
/* STEP 3: Perform specific commands depending on calling */ 
[* ------- exit point in APYPRTDEF x/ 
/* */ 


[RRR RK ERA KER AK KEI KK AKK EA KKK KEI AKIEKAKKKAKKKA KK EAR IKEA AKER AKER KKK | 


[RRR RK RRA KER AK REIKI KKK KKK KKK KKK KKKAKKA IKEA A KKK EA AKER KKK | 
/* SAMPLE CODE FOR *BEFORE */ 
[BRK RK RRR KER IKKE IKKE IKKE KK KEK KERIKERI KKK IKK IKKE AK KEI KKK AKIRA AK E EA KERR | 
STEP3_BEF: 
SNDMSG MSG('APU starts to process' *BCAT &EXJOBUSR + 

*TCAT '''s' *BCAT 'spooled file' *BCAT + 

&EXINFILE *TCAT '.' *CAT &EXINNBR *BCAT + 

‘type! *BCAT &EXINTYPE *BCAT 'from output + 

queue' *BCAT &EXINOQLB *TCAT '/' *CAT + 

&EXINOQNM) TOUSR(*SYSOPR) 


GOTO CMDLBL(STEP4) 


[BRK RK ERK KK RAK REIKI KKK KK IK KKK KERIKERI KEI KKEA KKK AKI KERIKERI KERR ARE | 
/* SAMPLE CODE FOR *MIDDLE */ 
[KEK RK ERA KK RAK REIKI AKER KK EAR KIRA KKKA KK A KK A KIKI A KERR RE | 
STEP3_MID: 
SNDMSG MSG('APU starts to generate AFP data using + 

print definition’ *BCAT &EXPRTDLB *TCAT + 

'/' *CAT &EXPRTDEF *TCAT '. (FYI: The + 

parameter at runtime for the program + 

which sent the message to you was -->' + 

*CAT &EXUSRPRM *CAT '<--)') TOUSR(*SYSOPR) 


GOTO CMDLBL(STEP4) 


[RRR KKK RRR AK KAR KKK KK EAR KKK K KKK KKK KK KIARA KK AK KA KKK KAKA KKK AKER A EKER KKK | 


/* SAMPLE CODE FOR *AFTER x/ 


[BRK RK ERIK REAR REIKI KKK KKK KKK A KERIKERI KK AKA KEI KK EKA K AIK EA KEE KKK | 


STEP3_AFT: 


IF COND(&EXSUCFLG = *YES) THEN(GOTO + 
CMDLBL(AFT_SUCC) ) 
ELSE CMD(GOTO CMDLBL(AFT_FAIL)) 
AFT_SUCC: 
SNDMSG MSG('APU successfully created the AFPDS + 
spooled file' *BCAT &EXOTFILE *BCAT ‘in + 
the output queue' *BCAT &EXOTOQLB *TCAT + 
'/' *CAT &EXOTOQNM *BCAT ‘with the flags + 
HOLD(' *CAT &EXOTHOLD *TCAT ') SAVE(' + 
*CAT &EXOTSAVE *TCAT ')') TOUSR(*SYSOPR) 
GOTO CMDLBL(STEP4) 
AFT_FAIL: 


SNDMSG MSG('WARNING: The AFP data stream which was + 
created by APU could not be printed with + 
the PRTAFPDTA command. (FYI: APU used + 
print definition’ *BCAT &EXPRTDLB *TCAT + 
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'/' *CAT &EXPRTDEF *BCAT 'for' *BCAT + 
&EXJOBUSR *CAT '''s' *BCAT ‘spooled file' + 
*BCAT &EXINFILE *TCAT '.' *CAT &EXINNBR + 
*BCAT 'type' *BCAT &EXINTYPE *BCAT 'from + 
output queue' *BCAT &EXINOQLB *TCAT '/' + 
*CAT &EXINOQNM *TCAT ')') TOUSR(*SYSOPR) 


GOTO CMDLBL(STEP4) 


[BRK R KKK KEKE IKKE KK KEK KKK KK ERIKA KK AK AKA KK EAB A KKK AKER KEK A KEE AK K ERK KEK | 


/* x/ 
/* STEP 4: Return to APYPRTDEF and continue processing x/ 
[* ------- */ 
/* */ 


[BRK RK KER KEKE AKER A KK EAA KEK K EKA KKK KK KEIRA KKK KK KIRKE KK KIARA KEI KK ER KEKE | 


STEP4: 
RETURN 
ENDPGM 
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APYPRTDEF Command 


When you are applying a print definition to a spool file using the APYPRTDEF 
command, a line appears on the bottom left of the display as an indicator of the 
processing _phases. The line contains 3 asterisks(***) in eight different positions. 
Refer to 


APU Defaults 


* When initially setting APU defaults, we recommend that you ensure that any 
libraries where code pages exist have been added to your current library list. 
Command line capability does not exist within APU to add any libraries from 
this display. 

* An administrator must ensure that enough library list entries are available 
during APU execution for the additional resources listed in the “Set APU 
Defaults” panel. 


Maximum APU Values 


Because APU builds structure into the document design, some limitations exist on 
those structural elements, as shown below. 


APU Function Maximum Value 

Input page width 250 characters 

Input page length 127 lines 

Number of selection rules per print definition 99 

Number of selection fields per print definition 600 (including constants in 
rules) 

Number of page formats per print definition 99 

Number of copies per page format 99 

Number of text mappings and suppressions per line 250 

Number of text constants per copy 250 

Number of bar code mappings and bar code constants per | 750 

copy 

Number of different font character sets per copy 32 

Number of boxes per copy 99 

Number of page segments per copy 99 

Number of overlays per copy 99 


Print Definition Creation 


* When you are creating a print definition and have selected a sample spool file, 
remember that you are selecting a spool file for reference purposes only. This 
spool file may or may not be the actual spool file that is specified for the print 
definition for printing. 
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Initially, the additional resource libraries field entries in the “Set Print Definition 
Attributes” panel are copied from the APU defaults. If a user overrides any of 
these resources on this panel, APU will only use these overridden resources. 
APU does NOT concatenate these overridden resources with entries that might 
have been specified in the APU defaults initially. 


You must ensure that a sufficient number of user library list entries exist when 
you are adding additional resources on the “Set Print Definition Attributes” 
display. 
If you create a print definition with two page formats, ensure that you code 
rules to handle both pages. APU does not assume an implied else statement to 
print a second page format. For example, to ensure pages that other than ‘Page 
2’ will print, code: 
IF PG2ONLY *EQ ‘Page 2' *USE = PG2 

*USE — *DEFAULT 
You can specify MULTIPLE PAGE FORMATS = *YES, and only have one page 
format, but RENAMING the *DEFAULT page format may not produce any 
output. If APU does not find a rule that refers to the RENAMED page format, 
APU attempts to find *DEFAULT as the page format to use, and because it 
would not find *DEFAULT, APU assumes *OMIT, does not print any copies 
contained within the RENAMED page format, and prints only the original input 
spooled file. To fix this, you can do one of the following: 


— Rename the Page Format back to *Default 
— Define a rule to *USE the new page format name 


Mapping Data 


Try to map a total area; don’t leave spaces between columns. This provides 
better performance. 


If you increase the line increment and utilize the repeat function, you could 
cause an error by trying to create data off the logical page. This should be 
considered when requesting rotation also. 


If you increase the line increment, you should also ensure the starting position 
down value is correct, it is not automatically recalculated for you; otherwise, 
your data may not be positioned in respect to other data on the page. 


You cannot place two constants on the same origin. If you feel that this is 
absolutely necessary to do this, you can trick the system by changing the unit of 
measure to UNITS, and just increment the origin by 1 unit. By doing this, the 
origin looks the same on different printers due to the rounding of pel 
placements they perform. 


Copies and Page Formats 
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* Take a lot of space; eliminate unused page formats or copies to speed up 


processing. 


We recommend that you determine that the first change is how you want it 
before continuing on with copies or page formats copied from first changes; 
otherwise, each copy/page format that was made would have to be modified 
rather than just the original. 

APU processes copies in alphabetical name order. For example, if you had two 
copies (PGE1 & PGB), and you want PGE1 associated with the first copy, you 
could rename PGE1 to PGA, so it is first alphabetically. 


Duplex 


* When you enable duplex printing on the “Set Page Layout Options” display, 
specify *NONE for Back Overlay on this display because APU cannot print text 
that includes overlays, page segments, and boxes on the front side of a duplexed 
sheet and then print an overlay on the back side of that duplexed sheet. 


* You can only specify duplex printing for consecutive pages of the same copy. 
When you are printing different copies, you cannot specify duplex printing. 


Creating Sample Spool Files 


The QRPGSRC member INVSCS has already been compiled in the QAPU library. It 
is called INVSCS *PGM. 


Creating Your Own Copy of INVSCS 


If you would like to create your own copy of INVSCS in your own OUTQ, issue 
the following commands from the command line: 
ADDLIBLE QAPU 


CALL PGM(QAPU/INVSCS) 
RMVLIBLE QAPU 


Recreating INVPRE and INVSCS 


If you would like to recreate the INVPRE and INVSCS files in the QYPUOUTQ, 
issue the following commands from the command line: 
ADDLIBLE QAPU 


CALL PGM(QAPU/QYPUCSPLF) 
RMVLIBLE QAPU 
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Appendix D. AFP Resource Commands 


This appendix describes how to build iSeries resource objects from font, overlay, 
and page segment files that are created on a client system. If you are using the 
Overlay Utility (part of AFPU) for overlays, you will not need the overlay 
commands. The Overlay Utility builds overlays directly on the OS/400. If you are 
using the Resource Management Utility (also part of AFPU), it provides the 
functions that are needed to build page segments. 


Creating Font Resources 


The following section describes how to create font resources. 


1. Create a temporary resource file as shown below. From an iSeries command 
line, issue the CRTPF command to create a file to receive the PC resources. The 
“Create Physical File (CRTPF)” panel appears. 


( Create Physical File (CRTPF) >) 
Type choices, press Enter. 
Piles cen Se tee eh ts cay caer cee eevee FILE > TEMPPF 
[SIDA View teense esheets ncn sretere rc > QTEMP 
SOURCE UG oo coesu te ieuse. cece yes SRCFILE QDDSSRC 
IETDY AIRY” see cir energy ee et ose ws *LIBL 
Source member os 3. sew ms SRCMBR *FILE 
Record length, if no DDS . . . . RCDLEN 32766 
Generation severity level . . . GENLVL 20 
Flagging severity level ... . FLAG 0 
Rises Ey Peyecmatmr eines scart ues eceee FILETYPE *DATA 
Member, if desired .. ..« « » MBR *FILE 
Text. "deseriptiion® fo ...50 ees TEXT "Temporary File' 
Bottom 
F3=Exit F4=Prompt F5=Refresh F10=Additional parameters  F12=Cancel 
F13=How to use this displa F24=More keys 
Ne play y ty, 
Figure 112. Create Temporary Resource File 
2. Transfer the font resource to the temporary resource file. 
(a > 
Copy From PC Document (CPYFRMPCD) 
Type choices, press Enter. 
BVOmotolideyr =", vs ccceis ct as coke FROMFLR resource 
MOS fill Cee nese otcs ee ken raueermees ae TOFILE temppf 
ETD IANS Viewewuc, caekstarsecue ret eats k qtemp 
From document: . 20. & 6. # @ FROMDOC newfont. fnt 
Wosmember: 3.2 odessa: hag ces se os TOMBR *FIRST 
Replace or add records ..... MBROPT *REPLACE 
Translate:table 3. <3 «oe = TRNTBL *none 
[DAR Vie tomteress se cens Se see eee 
Formatof PGadata: (au. 3 seeks TRNFMT *notext 
Bottom 
F3=Exit F4=Prompt F5=Refresh  F12=Cancel F13=How to use this display 
F24=More keys 


————— SSS aaa 


Figure 113. Copy From PC Document (CPYFRMPCD) panel 
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3. Create the Font Resource. Use the CRTFNTRSC command to create an iSeries 
font resource. 


ia 
Create Font Resource (CRTFNTRSC) 
Type choices, press Enter. 
FONEARCSOURCC Rater Gas ceep ees heoraees FNTRSC newfont 
ED Rary? Boise ace Corset hence) os: le *CURLIB 
EsliCuy ge caeceregcrnse eeraro anette rca FILE temppf 
Ello) Grell eA Baas eee tye Caper ore te A qtemp 
Member sin iyrec ee st asancle: G) aa oe MBR *FNTRSC 
Text: “description” « 33% «2 % TEXT "New Character Set' 
Bottom 
F3=Exit F4=Prompt F5=Refresh F10=Additional parameters  F12=Cancel 
ome to use this display F24=More keys 


Figure 114. Create Font Resource (CRTFNTRSC) panel 


Creating Overlay Resources 


The following section describes how to create overlay resources. 


1. Create a temporary resource file as follows. From an iSeries command line, 
issue the CRTPF command to create a file to receive the PC resources. The 
“Create Physical File (CRTPF)” panel appears. 


( Create Physical File (CRTPF) 
Type choices, press Enter. 
Pilla Gaereyt seer eth cop taas aeirra Ta FILE > TEMPPF 
IED IRAVie ce) vn Goto Sem svces avewec en >  QTEMP 
SOURCE Mae: ~aele. & asexsmcy econ Ge oe SRCFILE QDDSSRC 
[EDRARY 2 Se eet eese ts see rane *LIBL 
Source member .........- SRCMBR *FILE 
Record length, if no DDS... . RCDLEN 32766 
Generation severity level . . . GENLVL 20 
Flagging severity level ... . FLAG 0 
Filer ty Persices ccs tsere erste os FILETYPE *DATA 
Member, Vf desired . 2. 4 « « « MBR *FILE 
Text. "description® . 2... © « % TEXT "Temporary File' 
Bottom 
F3=Exit F4=Prompt F5=Refresh F10=Additional parameters  F12=Cancel 
eee to use this display F24=More keys 


Figure 115. Create Temporary Resource File panel 


2. Transfer the overlay file from the folder by using the CPYFRMPCD command: 
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i =~ 


Copy From PC Document (CPYFRMPCD) 
Type choices, press Enter. 
From folder <3 a < a. wo = FROMFLR resource 
Thom MMC ere eeccmsae shares icet oe TOFILE temppf 
IETID RGN: eo. ey anes ec vat oie oe ae qtemp 
Rrom-document. 3 =, 2. «3 FROMDOC newovl .oly 
Mosmember® ie <0 cee ces et yay oer se st oe TOMBR *FIRST 
Replace or add records ..... MBROPT *REPLACE 
Translate: table s. .. sa 3s TRNTBL *none 
EVDRARYe Cepce coer kets ea ee cons 
Format: tof PG:data. ..  . ks TRNFEMT *notext 
Bottom 
F3=Exit F4=Prompt F5=Refresh  F12=Cancel F13=How to use this display 
F24=More keys 
XY 7 
Figure 116. Copying Overlay File from Folder 
3. Create the Overlay. Use the CRTOVL command to create an iSeries overlay: 
‘e Create Overlay (CRTOVL) ) 
Type choices, press Enter. 
Overlay: 24s Sw oe SS OVL newov] 
Wilbrarey: (2) oy ceueeneeesy eine ccaueoes *CURLIB 
Fill @e coyasuee® aa caret env estas tsa tenes FILE temppf 
ISTIDIGANSY Rot statesessratse vos caah-es no oe onetiye qtemp 
Members eric shoes gs teil oe: Heavies MBR *OVL 
Data. type a sce oe: ee eee ee es DATATYPE *AFPDS 
Text. “deseriptiom .. «, a. tos. ee TEXT "New Overlay' 
Bottom 
F3=Exit F4=Prompt F5=Refresh F10=Additional parameters  F12=Cancel 
F13=How to use this display F24=More keys 
XX 2 


Figure 117. Create Overlay (CRTOVL) panel 


An alternative to using the individual steps that are described above is to build 
and use the OVERLAY command. Refer to the iSeries Guide to AFP Printing and PSF 
for details. 


Creating Page Segment Resources 


The following section describes how to create page segment resources. 


1. Create a temporary resource file as follows. From an iSeries command line, 
issue the CRTPF command to create a file to receive the PC resources. The 
“Create Physical File (CRTPF)” panel appears. 
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Create Physical File (CRTPF) 
Type choices, press Enter. 
Fal Later conten te cen a cant ie nek ee ereeares oe FILE > TEMPPF 
[EDA sett: eon Us wer tema ecicee se >  QTEMP 
SOURCE? Till'Ga wy 1 ihe vee eee ee oe SRCFILE QDDSSRC 
ISDA ence, ee cot See ee tens vtec a) *LIBL 
Source member .........- SRCMBR *FILE 
Record length, if no DDS... . RCDLEN 32766 
Generation severity level . . . GENLVL 20 
Flagging severity level ... . FLAG 0 
Biles typeamciecercercue esate oe eae ns FILETYPE *DATA 
Member, if desired ....... MBR *FILE 
Text. *deseription® 2 3 fs. eo TEXT "Temporary File' 
Bottom 
F3=Exit F4=Prompt F5=Refresh F10=Additional parameters  F12=Cancel 
F13=How to use this display F24=More keys 
4 
Figure 118. Create Temporary Resource File 
2. Transfer the page segment file to the temporary resource file by using the 
CPYFRMPCD command. 
( Copy From PC Document (CPYFRMPCD) > 
Type choices, press Enter. 
Frromiytodiders sess ke: ae Arg FROMFLR resource 
OTC oe eeeen sh syns see ome TOFILE temppf 
DYN YS es. eos Genie eek ae es qtemp 
From document ......... FROMDOC newimg.psg 
TOnMemMbER™ <r. fer Pes or ess ee ce es TOMBR *FIRST 
Replace or add records ..... MBROPT *REPLACE 
Translate table... 2 Ss. a TRNTBL *none 
[VDA Vieoese cam uteavsasassene crate 
Formatof PGidata i. 3. 0.6 403 TRNFEMT *notext 
Bottom 
F3=Exit F4=Prompt F5=Refresh  F12=Cancel F13=How to use this display 
F24=More keys 
a 
Figure 119. Copy Page Segment to Temporary File 
3. Create the page segment by using the CRTPAGSEG command. 
Create Page Segment (CRTPAGSEG) 
Type choices, press Enter. 
Page “SEGMeNit ss. sm ss. cer 6 eye, 5, ee PAGSEG newimg 
EV Da bYeeG ete te tcan ee taccaes! cen cea’ *CURLIB 
Rill @Seegerser caked ec ecmeenton Poses arses crate FILE temppf 
Dat eet e ct esse ca eee ce qtemp 
Member. 3 8% eae 2 See MBR *PAGSEG 
Text: "description" «3 3-2 @ 2% TEXT "New Page Segment ' 
Bottom 
F3=Exit F4=Prompt F5=Refresh F10=Additional parameters  F12=Cancel 
F13=How to use this displa F24=More keys 
Ss play y y 


Figure 120. Create Page Segment (CRTPAGSEG) panel 


Fill in the fields as as shown in the panel above to create an iSeries page segment. 
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You can automate the above process by using the SEGMENT command.Refer to 
the iSeries Guide to Advanced Function Presentation and Print Services Facility for 
details. 
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Appendix E. Rotation Hints 


Methods of Rotating Text Data 
Figure 121] shows the methods in which text data can be rotated. 
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Figure 121. Rotation Hints 


Note: Asterisks in the figure above indicate where text can be truncated on certain 
rotated pages if page length or page width values are not considered. Text 
can always be truncated on all output pages if line increment values force 
data to be greater than the page length. 


General Rules 


The general rules APU follows when rotating data are: 


1. APU always attempts to create output in Portrait mode and attempts rotation 
based upon the page length and page width (orientation) of the original 
selected sample spool file. 

2. When overriding input or default rotation values, use the following guidelines 
to avoid text truncation or object positioning problems. 

* Specifying a rotation of 0 or 180 degrees, ensure the page length value is 
greater than the page width value. 
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* Specifying a rotation of 90 or 270 degrees, ensure the page width value is 
greater than the page length value. 
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Appendix F. Font Samples 


This appendix presents a sampling of various fonts provided by IBM. 


Times New Roman Medium 


FONT NAME 


Times New Roman Medium 6pt 

Times New Roman Medium 7pt 

Times New Roman Medium 8pt 

Times New Roman Medium 9pt 
Times New Roman Medium 10pt 


Times New Roman Medium 11 pt 
Times New Roman Medium 12pt 


Times New Roman Medium 14pt 
Times New Roman Medium 1 6pt 


Times New Roman Medium 18pt 
Times New Roman Medium 20pt 


Times New Roman Medium 24pt 
Times New Roman Medium 30pt 


Times New Rom Med 36pt 


Figure 122. Times New Roman Medium 


Note: The outline font is CZN200. 
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Character 
Set 


CON20060 
CON20070 
CON20080 
CON20090 
CON20000 


CON200A0 
CON200B0 


CON200D0 
CON200F0 


CON200HO 


CON200J0 


CON200NO 


CON200T0 


CON200Z0 
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Helvetica Roman Bold 


FONT NAME Point 
Size 
Helvetica Roman Bold 6pt 6 
Helvetica Roman Bold 7pt 7 
Helvetica Roman Bold 8pt 8 
Helvetica Roman Bold 9pt 9 
Helvetica Roman Bold 10pt 10 
Helvetica Roman Bold 11pt 1 
Helvetica Roman Bold 12pt 12 
Helvetica Roman Bold 14pt 4 
Helvetica Roman Bold 16pt 16 
Helvetica Roman Bold 18pt 18 


Helvetica Roman Bold 20pt 20 
Helvetica Roman Bold 24pt 24 
Helvetica Roman Bold 30pt_ . 


Helvetica Rom Bid 36pt . 


Figure 123. Helvetica Roman Bold 


Note: The outline font is CZH400. 
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Character 
Set 


COH40060 
COH40070 
COH40080 
COH40090 
COH40000 
COH400A0 


COH400B0 


COH400D0 


COH400FO 


COH400HO 


COH400J0 


COH4O0NO 


COH400TO 


COH400ZO 


Courier 


FONT NAME 


Courier Roman Medium 7pt 

Courier Roman Medium 8pt 

Courier Roman Medium 10pt 

Courier Roman Medium 12pt 
Courier Roman Medium 14pt 


Courier Roman Medium 20pt 


Courier Roman Bold 7pt 

Courier Roman Bold 8pt 

Courier Roman Bold 10pt 
Courier Roman Bold 12pt 
Courier Roman Bold 14pt 


Courier Roman Bold 20pt 


Courier Italic 7pt 

Courier Italic 8pt 

Courier Italic 10pt 
Courier Italic 12pt 
Courier Italic 14pt 


Courier Italic 20pt 


Courier Italic Bold 7pt 

Courier Italic Bold 8pt 

Courier Italic Bold 10pt 
Courier Italic Bold 12pt 
Courier Italic Bold 14pt 


Courier Italic Bold 20pt 


Figure 124. Courier Font Samples 


Point Character 
Size Set 


7 ©€0420070 
8 C0420080 
10 ©C0420000 
12 C04200B0 
14 C04200D0 


20 CO04200J0 


7 C0440070 
8 C0440080 
10 C0440000 
12 C04400B0 
14 C04400D0 


20 C04400J0 


7 ©€0430070 
8 C0430080 
10 C0430000 
12 C04300B0 
14 C04300D0 


20 C04300J0 


7 ©0450070 
8 C0450080 
10 C0450000 


12 C04500B0 
14 C04500D0 


20 CO04500J0 


Note: The outline font is CZ4200, CZ4300, CZ4400, or CZ4500. 
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Glossary 
A 


ACIF AFP Conversion and Indexing Facility. An AFP 
program you can use to convert a print file into a 
MO:DCA-P document, to retrieve resources used by the 
document, and to index the file for later retrieval and 
viewing. 


addressable point. Any point in a presentation surface 
that can be identified by a coordinate from the 
coordinate system of the presentation medium. See also 


pel. 


Advanced Function Presentation (AFP). A set of 
licensed programs that use the all-points-addressable 
concept to print data on a wide variety of printers or 
display data on a variety of display devices. AFP also 
includes creating, formatting, archiving, viewing, 
retrieving, and distributing information. 


Advanced Function Presentation data stream. A 
presentation data stream that is processed in the AFP 
environment. MO:DCA-P is the strategic AFP 
interchange data stream. IPDS is the strategic AFP 
printer data stream. 


Advanced Function Printing Utilities for iSeries (AFP 
Utilities). An IBM licensed program that includes a 
group of utilities that work together to provide 
Advanced Function Printing on iSeries. 


Advanced Print Utility (APU). Part of the AFP 
PrintSuite family of application enablers that allow 
end-users to migrate existing application to advanced 
electronic documents. 


AFP. Advanced Function Presentation. 


AFP API. Advanced Function Presentation 
Application Programming Interface 


AFPDS. A synonym for the composed page, 
MO:DCA-P-based data stream interchanged in AFP 
environments. 


AFP Utilities for iSeries (AFP Utilities). Advanced 
Function Printing Utilities for iSeries (AFP Utilities) 


AFP Workbench for Windows. A platform for the 
integration of AFP enabling applications and services. 
The Viewer application is a Workbench application that 
runs under WIN-OS/2 or Microsoft Windows. 


all-points addressable (APA). The capability to 
address, reference, and position text, overlays, and 
images at any defined point (pel) on the printable area 
of the paper. See page mode. 
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American National Standard Code for Information 
Interchange. A standard code, using a coded character 
set consisting of 7-bit coded characters (8-bits, 
including the parity check), that is used for information 
interchange among data processing systems, data 
communication systems, and their associated 
equipment. The ASCII set consists of control characters 
and graphic characters. 


APA. All points addressable. 


APA printers. Devices that are all points addressable; 
in other words, devices that print with picture elements 
on the printing medium at any valid location on a 
sheet of paper. 


application program. A program written for or by a 
user that applies to the user’s work, such as a program 
that does inventory control or payroll. 


application programmer. A programmer who is 
responsible for writing programs for specific 
applications. The application programmer takes 
application data and writes programs to print it on line 
and AFP printers. 


Application System/400. The hardware on which the 
OS/400 operating system runs. 


APU. Advanced Print Utility 


APU Monitor. A program that, when processed, 
applies print definitions to selected spooled files so that 
the spooled files are automatically converted to AFP 
printer files. 


architecture. The set of rules and conventions that 
govern the creation and control of data types such as 
text, image, graphics, font, fax, color, audio, bar code, 
and multimedia. 


ASCII. American National Standard Code for 
Information Interchange 


bar code. A code representing characters by sets of 
parallel bars of varying thickness and separation that 
are read optically by transverse scanning. 


baseline. Ina font, the imaginary line on which 
successive characters are aligned in the inline direction. 


batch. (1) A group of records or data processing jobs 
that are brought together for processing or 
transmission. (2) Pertaining to activity involving little 
or no user action. Contrast with interactive. 
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batch environment. The environment in which 
noninteractive programs are run. The environment 
schedules their processing independently of their 
submitter. Contrast with interactive environment. 


Bar Code Object Content Architecture (BCOCA). 


C 


character. (1) A symbol that is used in printing. For 
example, a letter of the alphabet, a numeral, a 
punctuation mark or any other symbol that represents 
information. (2) A byte of data. 


character graphic. The visual representation of a 
character, defined by toned or untoned picture 
elements (pels). An untoned pel (a reverse character) is 
visually represented by the toned pels around it. 


character increment. The distance the current print 
position is increased by printing the current character 
graphic. 


character rotation. The alignment of a character 
relative to the baseline that is measured in degrees in a 
clockwise direction. Examples are 0°, 90°, 180°, and 
270°. 


code page. A font component that associates code 
points and character identifiers. A code page also 
identifies how undefined code points are handled. 


code point. A 1-byte code that represents one of 256 
potential characters. 


continuous-forms paper. A series of connected forms 
that feed continuously through a printer. The 
connection between the sheets is perforated to allow 
the user to tear them apart. Before printing, the sheets 
are folded in a stacked arrangement, with the folds 
along the perforations. (Note that some continuous 
forms are in rolls and are not folded.) Contrast with 
cut-sheet paper. 


copy. The specification level of an APU print 
definition where most layout work, such as specifying 
page layout options, selecting and placing images, and 
defining constants and boxes, is done. 


cut-sheet paper. Paper that is cut into separate sheets 
before being printed on. Contrast with 
continuous-forms paper. 


D 


database. A set of data, part or the whole of another 
set of data that consists of at least one file, and that is 
sufficient for a given purpose or for a given 
data-processing system. 


DDS. Data Description Specifications 
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data set. Synonym for file. 


data stream. (1) All data transmitted through a data 
channel in a single read or write operation. (2) A 
continuous stream of data elements being transmitted, 
or intended for transmission, in character or 
binary-digit form, using a defined format. (3) Records 
sent to PSF from the spooled files and the resource 
libraries. 


direction. The print position of data on a logical page, 
line, or field. The ultimate reference point for all 
direction controls on a page is the hardware origin. 
Secondary and tertiary reference points are possible as 
well, allowing more than one print direction on a page. 


duplex printing. Pertaining to printing on both sides 
of a sheet of paper. Contrast with simplex printing. 


E 


electronic overlay. Synonym for overlay. 


external formatting. Controls for the placement of 
data on the page that are embedded outside the actual 
application program. 


F 


field. In a record, a specified area used for a particular 
class of data; for example, a group of character 
positions that are used to enter or display wage rates 
on a screen. 


font. A family or assortment of characters of a given 
size and style; for example, 9-point Sonoran Serif 
roman medium. 


font administrator. A person who is responsible for 
installing and maintaining the fonts that are stored in 
computer resource libraries. 


font metrics. Measurement information that defines 
individual character values such as height, width, and 
space as well as overall font values such as the average 
and maximum heights and widths of characters. Font 
metrics can be expressed in specified fixed units, such 
as pels, or in relative units that are independent of both 
the resolution and size of the font. 


form. (1) The paper on which output data is printed 
by a line printer or a page printer. (2) A physical sheet 
of paper. See preprinted form. 


form definition. A resource that defines the 
characteristics of the form which include overlays to be 
used (if any), text suppression, the position of page 
data on the form, and the number and modifications of 
a page. Contrast with page definition. 


format. (1) A specified arrangement of such things as 
characters, fields, and lines, that are usually used for 


displays, printouts, or files. (2) To arrange such things 
as characters, fields, and lines. (3) (v.) To prepare a 
document for printing in a specified format. 


formatter. A computer program that prepares a source 
document for printing. 


forms designer. A person who is responsible for 
designing electronic or preprinted forms that are 
readable, usable, and attractive. The forms designer 
usually has training in graphics design and in the 
presentation of information. 


G 


GDDM. Graphical Data Display Manager. An IBM 
licensed program containing utilities for creating, 
saving, editing, and displaying visual data such as page 
segments, charts, images, vector graphics, composites 
(of text, graphics, and images), and scanned data. 


graphic. Image, text, or a combination of both that can 
be placed on the printed page. 


graphics designer. A person who is responsible for the 
design and appearance of graphics used in a 
company’s documents. The graphics designer has 
experience in graphics design as well as in using 
computers to create graphics. 


H 


host-based computer. (1) In a computer network, a 
computer that provides end users with services such as 
computation and databases and that usually performs 
network control functions. (2) The primary or 
controlling computer in a multiple-computer 
installation. 


human readable information (HRI). Symbols that can 
be understood by humans, as distinct from those that 
cannot (such as bar codes). 


image. A pattern of toned and untoned pels that form 
a picture. 


impact printer. A device in which printing results 
from mechanical impacts. Contrast with nonimpact 
printer. 


index. (1) A process of segmenting a spooled file into 
uniquely identifiable groups of pages (a named 
collection of sequential pages) for later retrieval. (2) A 
process of matching reference points within a file and 
creating structured field tags within the MO:DCA-P 
document and the separate index object file. 


interactive. Pertaining to an application in which 
entries call forth a response from a system or program, 


as in an inquiry system. An interactive system might 
also be conversational, implying a continuous dialog 
between the user and the system. Interactive systems 
are usually communicated with through terminals, and 
respond immediately to commands. 


L 


LAN. Local area network 


LAN administrator. A person responsible for 
installing, configuring, and maintaining Local Area 
Networks on which are installed workstations and 
printers. 


library. A file or a set of related files; for example, a 
page definition library that contains one or more page 
definition files. 


licensed program. A utility that performs a function 
for the user and usually interacts with and relies on 
system control programming or some other 
IBM-provided control program. A licensed program 
contains logic related to the user’s data and is usable or 
adaptable to meet specific requirements. 


line data. Data prepared for printing on a line printer 
such as an IBM 3800 Model 1 Printing Subsystem. Line 
data is usually characterized by carriage-control 
characters and table reference characters. Contrast with 
MO:DCA-P data. 


line-data print file. A file that consists of line data, 
optionally supplemented by a limited set of structured 
fields. 


line printer. A device that prints a line of characters 
as a unit. 


lines per inch (lpi). (1) A unit of measurement for the 
specification of baseline placement. (2) A measure of 
the number of lines per vertical inch of paper. 


logical page. A presentation space. One or more object 
areas or data blocks can be mapped to a logical page. A 
logical page has specifiable characteristics, such as size, 
shape, orientation, and offset and is rectangular in 
shape. Orientation and offset are specified relative to a 
medium coordinate system. 


Ipi. Lines per inch. 


magnetic ink character recognition (MICR). 
Recognition of characters printed with ink that contains 
particles of a magnetic material. 


metafile format. OS/2 graphics data that is produced 
by Presentation Manager applications such as IBM 
CAD, CorelDRAW, or Aldus Pagemaker. 
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MICR. Magnetic ink character recognition. 


Mixed Object Document Content Architecture 
(MO:DCA-P). A strategic, architected, 
device-independent data stream for interchanging 
documents. 


mixed-pitch font. A font that simulates a 
proportionally spaced font. The characters are in a 
limited set of pitches (for example, 10 pitch, 12 pitch, 
and 15 pitch). 


monospaced font. A font in which the graphic 
characters have a uniform character increment. 
Synonymous with uniformly spaced font. Contrast with 
proportionally spaced font. 


multiple-up printing. The printing of more than one 
page on a single surface of a sheet of paper. 


N 


nonimpact printer. A device in which printing is not 
the result of mechanical impacts; for example, 
heat—sensitive printers, electrostatic printers, 
photographic printers. Contrast with impact printer. 


O 


object format. The format of AFP resources required 
for use by PSF. Contrast with source format. 


offset stacking. A function that allows the printed 
output pages to be offset for easy separation of the 
print jobs. 


Operating System/2 (OS/2). An IBM licensed program 
that can be used as the operating system for the PS/2 
processor series. 


Operating System/400 (OS/400). An IBM licensed 
program that can be used as the operating system for 
the iSeries processor series. 


orientation. (1) The angle between the top or bottom 
edge of the page and the baselines within a column 
that is measured in a clockwise direction. (2) The 
rotation of an element relative to a fixed reference. 


outline font. A font whose graphic character shapes 
are defined mathematically rather than by raster 
patterns. 


output device. A machine used to print, display, or 
store the result of data processing. 


overlay. A resource that can contain text, image, 
graphics, and bar code data. An overlay is 
electronically created in the host processor, stored in a 
library, and can be merged electronically with variable 
data on a sheet during printing. See also preprinted 
form and forms flash. 
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Overlay Generation Language/370 (OGL/370). An 
IBM licensed program used to create overlays. 


p 


page. A collection of data that can be printed on a 
physical sheet of paper. 


page definition. A resource that contains a set of 
formatting controls for printing logical pages of data. 
Includes controls for number of lines per printed sheet, 
font selection, print direction, and mapping individual 
fields in the data to positions on the printed sheets. 


page format. (1) A subset of a page definition that 
contains controls governing the arrangement of text on 
a page. (2) In APU, the object that contains all of the 
instructions for formatting a print job. A print 
definition can name one or more page formats. 


page mode. The mode of operation in which the 
printer can accept a page of data at a time from a host 
processor to be printed on an all-points addressable 
output device. Data may consist of pages that 
arecomposed of text, images, overlays, or page 
segments. 


page printer. Any of a class of printers that accepts 
MO:DCA-P pages, constructed of composed text and 
images, among other things. Contrast with line printer. 


Page Printer Formatting Aid. An IBM licensed 
program that you can use to create and store form 
definitions and page definitions. 


page segment. A resource that contains composed text 
and images, prepared before formatting and included 
during printing. 


pel. The smallest area that can be individually toned 
on a printing medium or on a display surface. 


pel density. The number of pels per unit of linear 
measurement. 


physical page. The side of a sheet of paper that is to 
be printed on. 


pica. A unit of about 1/6 inch used in measuring 
typographical material. 


picture element. An element of a raster pattern about 
which a toned area on the photoconductor might 
appear. See also raster pattern. Synonym for pel. 


pitch. A unit of measurement for the width of a 
printed character, reflecting the number of times a 
graphic character can be set in 1 linear inch; for 
example, 10-pitch has 10 graphic characters per inch. 
Uniformly spaced fonts are measured in pitch. Contrast 
with point. 


plotter. An output unit that presents data in the form 
of a two-dimensional graphic representation. 


point. In printing, a unit of about 1/72 of an inch 
used in measuring typographical material. Each pica 
contains 12 points. 


point size. The height of a font in points. 


postprocessing option. A hardware device that 
attaches to the output side of a printer; for example, an 
envelope stuffer, binder, or stapler. 


PostScript. A page description language with 
interactive graphics capabilities that was developed by 
Adobe Systems, Incorporated. 


preprinted form. A sheet of paper that contains a 
preprinted design of constant data. Variable data can be 
merged on such a form. 


preprocessing option. A hardware device that attaches 
to the input side of a printer; for example, a paper-roll 
feed or multiple input bins. 


print data set. Synonym for print file. 


print definition. Contains instructions for 
transforming simple SCS print output to advanced AFP 
output. A print definition includes the specifications for 
remapping existing print data, defining and creating 
different page formats and copies, and adding 
document elements such as overlays, images, fonts, bar 
codes, and constants. 


print file. A file created by an application program 
that contains the actual information to be printed and 
some of the data that controls the format of the 
printing. Print files can contain MO:DCA-P data, line 
data, or a combination of MO:DCA-P and line data. 


print job. The data to be printed that is submitted to 
Print Services Facility by the user. 


Print Services Facility (PSF). An IBM licensed 
program that produces printer commands from the 
data sent to it. 


printer driver. A program that passes commands and 
resources with a data stream from the system spool to 
tell the printer how to print the page. 


proportionally spaced font. A font in which the 
characters have different character increments. Graphic 
character widths vary with the size of each graphic 
character. This allows for even spacing between printed 
characters and eliminates excess space around narrow 
characters, such as the letter i. Contract with uniformly 
spaced font. 


R 


raster font. (1) A font created by a series of pels 
(picture elements) arranged in scan lines to form an 
image. (2) A font in which the characters are defined 
directly by the raster bit map. 


raster graphics. Computer graphics in which a display 
image is composed of an array of picture elements 
(pels) arranged in rows and columns. Contrast with 
vector graphics. 


raster pattern. A series of picture elements (pels) in 
scan lines to form an image. See also page segment. 


record. A collection of related data or words, treated 
as a unit; for example, in stock control, each invoice 
could constitute one record. 


remote printer. A device that prints in a location away 
from the centralized data processing center. 


resource. A collection of printing instructions and 
sometimes data to be printed consisting entirely of 
structured fields. A resource can be stored as a member 
of a library and can be called for by Print Services 
Facility when needed. Coded fonts, font character sets, 
code pages, page segments, overlays, form definitions, 
and page definitions are all resources. 


resource library. (1) A collection of related files. (2) A 
place to store resources such as form definitions, page 
definitions, page segments, fonts, and overlays. 


rotation. The number of degrees a character is rotated 
relative to the print direction. One of four directions 
that define the orientation of text relative to a sheet, 
page, overlay, text block, or page segment. 


S 


scanner. A device that examines a spatial pattern one 
part after another and generates analog or digital 
signals corresponding to the pattern. Scanners are often 
used in mark sensing, pattern recognition, or character 
recognition. 


SCS. See SNA character string (SCS) 
segment. See page segment. 


simplex printing. Printing on only one side of the 
paper. Contrast with duplex printing. 


SNA. Systems Network Architecture (SNA) 


SNA character string (SCS). In SNA, a data stream 
composed of EBCDIC controls, optionally intermixed 
with end-user data, that is carried within a 
request/response unit. 
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software. Programs, procedures, rules, and any 
associated documentation pertaining to the operation of 
a system. Contrast with hardware. 


source format. The format of an AFP resource, other 
than fonts, used by AFP resource management 
programs. Contrast with object format. 


spooling (simultaneous peripheral operation online). 
(1) The use of auxiliary storage as a buffer storage to 
reduce processing delays when transferring data 
between peripheral equipment and the processors of a 
computer. (2) The reading of input data streams and 
the writing of output data streams on auxiliary storage 
devices, concurrently with job execution, in a format 
convenient for later processing or output operations. 


syntax. The rules and keywords that govern the use of 
a programming language. 


system printer. The printer that is used for any 
printed output that is not specifically directed to 
another printer. 


system programmer. A programmer who is 
responsible for writing programs for the functions of 
the computer operating system and who has a 
thorough knowledge of the operating system. The 
system programmer installs and maintains AFP 
software in the System/390 environment. 


Systems Network Architecture (SNA). In IBM 
networks, the description of the layered logical 
structure, formats, protocols, and operational sequences 
that are used for transmitting information units 
through networks, as well as controlling the 
configuration and operation of networks. 


7 


terminal. A device that is usually equipped with a 
keyboard and some kind of display, capable of sending 
and receiving information over a communication 
channel. 


text. A graphic representation of information on an 
output medium. Text consists of alphanumeric 
characters and symbols that are arranged in 
paragraphs, tables, columns, or other shapes. 


text-formatting program. A program that determines 
the manner in which data will be placed on a page. 


text orientation. A description of the appearance of 
text as a combination of inline and baseline directions 
and character rotation. 


Transmission Control Protocol/Internet Protocol 
(TCP/IP). A set of communications protocols that 
support peer-to-peer connectivity functions for both 
local and wide area networks. 
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type family. A collection of fonts of a common type 
face that vary in size and style. 


type font. Type of a given size and style; for example, 
10-point Sonoran Serif roman medium. 


type face. A collection of fonts all having the same 
style, weight, and width; each font differs from the 
others by point size or type family. 


typographic font. A typeface originally designed for 
typesetting systems. Contrast with mixed-pitch font, 
uniformly spaced font. Synonym for proportionally 
spaced font. 


U 


underscore. A line printed under a character. To 
underline. 


uniformly spaced font. A font in which the characters 
have the same character increment. Synonymous with 
monospaced fonts. Contrast with proportionally spaced 
font and typographic font. 


V 


variable data. (1) In programming languages, a 
language object that may take different values, one at a 
time. The values of a variable are usually restricted to a 
certain data type. (2) A quantity that can assume any of 
a given set of values. (3) Used to represent a data item 
whose value can be changed while the program is 
running. Contrast with constant data. 


vector. In computer graphics, a directed line segment. 


vector graphics. Computer graphics in which display 
images are generated from display commands and 
coordinate data. Contrast with raster graphics. 


W 


word processing. The entry, modification, formatting, 
display, and printing of text on personal computers, 
microprocessors, and stand-alone word processors. 
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